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Preface — Part One 


Welcome to the Sun Workstation. This manual provides a tutorial introduction to help you get 
used to the main ideas of the system and to begin to make use of them quickly and efficiently. 
We assume that you are a first-time Sun system user, but that you already knovr something 
about an operating system, a terminal keyboard, and a text editor. We provide explanations 
and exercises for learning to use the Sun system and Sun Workstation in particular, however, 
most of the information is also applicable to using UNIX on ASCII terminals. 

We introduce many of the new ideas and terms to you in this Preface to give you an idea of 
what the terminology is like. Ebcplanations are provided in the following chapters. 

The Sun Workstation is a desktop graphics computer designed to support a wide range of 
engineering, scientific, and CAD/CAM applications. Sun software b based on the UNIX system 
developed at the University of California at Berkeley (4.2bsd) and supports some of the most 
powerful graphics and user-interface software packages available. It is compatible with other 
versions of UNIX. The Sun system features include efficient networking, support for virtual 
memory through demand-paging, a high-performance file system, and an advanced graphical 
user interface. 

This powerful graphics computer supports up to four megabytes of main memory, various disks 
and tapes, and local area networking. It runs the Sun operating system, the basic resident code 
on which everything else depends. It is an advanced version of the UNIX operating system origi¬ 
nally developed at Bell Laboratories. The operating system supports the system calls and main¬ 
tains the file system. 

The Sun system capabilities include re-entrant code for user processes; ‘group’ access permis¬ 
sions for cooperative projects with overlapping memberships; alarm-clock timeouts; timer- 
interrupt sampling and interprocess monitoring for debugging and measurement; and multi¬ 
plexed I/O for machine-to-machine communication. It also provides powerful network protocols 
for local nets. 

The Sun system supports most of the available UNIX programs. The commands arc self- 
contained and do not require extra setup. You can run interactive programs, that is, ones that 
prompt you for information, from a prepared script or file simply by redirecting input. Most 
programs intended for interactive use, the text editors for example, provide escapes to the com¬ 
mand level interpreter called the Shell. Most file processing commands can also go from stan¬ 
dard input to standard output through filters. You can use the piping facility of the Shell to 
connect such filters directly to the input or output of other programs. 

The Sun system provides the following classes of utility programs: 

1. File Manipulation 

2. The Shell 

3. Programming Languages, such as C, Fortran??, and Pascal. 
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4. Text Editing and Document Processing, such as the vi editor and troff for phototypesetting 
documents. 

5. Information handling, networking, graphics, and games. 

6. System Management 

See the Sun System Summary tor an overview. 

If you already know something about UNIX, much of thb material will look familiar, but its 
organization may be somewhat foreign. This format provides exercbes for learning to use the 
system and does not explain the internab of the commands and programs. For more in-depth 
information on the Sun system and the UNIX operating system in general, there b a plethora of 
Sun documentation and literature, which is Ibted in the appendix. We refer to these manuab 
from time to time in this tutorial to draw you a roadmap of where to go from here with your 
education. 

Part One of the Beginner *$ Guide to the Sun Workstation describes the basic tools you need to 
learn to use the Sun system. Part Two provides information on how to use the Shells, the maii 
facility, and the network news. Also included b a glossary and an annotated bibliography. 

The chapters in Part One are: 

1. Getting Started — Explains how to log in, the Sun system file directory structure, how to 
use some basic system commands, and how to log out. 

2. Working With Files — Describes commands for manipulating your files. 

3. Using The Shell — Instructs you how to use the Shell commands and SunWindows to make 
your work easier. 

4. Creating and Editing Text Files — The *vi* Editor — Provides instructions on the most 
useful editor commands. 

5. Printing and Formatting Documents — Explains how to use the most useful text for¬ 
matters and macro packages and how to dbplay and print document copies. 

6. Communications — Introduces the communication facilities and describes how to use the 
mail system, how to talk to users on other systems, and how to use your local network. 

7. Sun System Summary — Look here for a nutshell version of Sun hardware and software 
features. 

You should have a couple of other documents with you for easy reference as you begin. The 
most important is the User^s Manual for the Sun Workstation; itb often easier to tell you to 
read about something in the user^s manual than to repeat its contents here. The user’s manual 
also lists all the manuals supplied with the Sun Workstation. The other useful document b the 
Editing and Text Processing on the Sun Workstation, which explains how to use the text for¬ 
matters and the vi editor. 
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Chapter 1 


Getting Started 


Sit down at your Sun Workstation. To use this tutorial, do the exercises and then experiment 
with the suggested options. Look up the commands in the user^s manual to get an idea of their 
additional capabilities. If you don^t get a desired response, poke around with the available 
options and commands until you do. Don^t be afraid to sample other commands described in the 
user’s manual; experimenting will quickly teach you how to work your way around the system. 

l.l. Logging In 

Examine the workstation screen. Since every system has a name, your screen displays some¬ 
thing like 

tutorial login: 

where ^tutorial’ is the system’s name or hostname. Your installation may have a naming theme, 
such as naming all systems after planetary bodies, but for our purposes, let’s use the hostname 
‘tutorial.’ It’s important to remember your system’s hostname and the names of your colleagues’ 
so you can communicate with them and share files over the network. 

To begin, you also need a login n^e (also known as an account which your system adminis¬ 
trator sets up for you along with your system. To set up your own account or add a user, refer 
to the adduser command in the System Manager's Manual for the Sun Workstation. 

Be aware that the Sun system has a strong orientation towards lower-case characters and makes 
a definite distinction between upper and lower case. Type your name in lower case if possible 
— if you type in upper case, the Sun system assumes your terminal can’t talk lower case and so 
talks at you in upper case from here on. Sun system commands are almost always in lower case. 
If we begin a sentence with a command name in this manual, the first letter is capitalized as a 
courtesy to English. 

After you have typed your login name, and pressed the RETURN key, the system prompts you 
for a password if your account is set up with one. For example, your screen looks like: 

tutorial login: evan 
Password: 

when it is waiting for your password. Type your password and press RETURN. The system 
doesn’t display or ‘echo’ your password, nor does the cursor even move as you type. This 
keeps your password secret from anyone who is looking over your shoulder. If you don’t have a 
password, typing your login name and pressing RETURN gets you straight onto the system. If 
you make a mistake typing in your login name, press the DEL key to back up over your mistake, 
and retype the correct characters. You can also simply press the RETURN key several times 
until you see the ‘tutorial login:’ prompt again and start over. Sometimes you may mistype 
your password, and see the same message as if you had mistyped your login name: 
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tutorial login: evan 
Password: 

Login incorrect 
tutorial login: 

Simply retype your login name and password to log in. 

You know you’ve logged on successfully when the system displays some messages and then 
displays a ready prompt. The display Is either: 

tutorial login: evan 
Password: 

Last login: Mon Jul 18 07:50:22 on ttypO 
Sun UNIX 4.2 UNIX (Berkeley beta release) (GENERIC) #8: Wed Oct 23 13:45:52 PDT 1983 
tutorial^ 


or 

tutorial login: evan 
Password: 

Last login: Mon Jul 18 07:50:22 on ttypO 

Sun UNIX 4.2 UNIX (Berkeley beta release) (GENERIC) #8: Wed Oct 23 13:45:52 PDT 1983 

I 

The and prompts indicate that the UNIX command interpreter, the SheU, is waiting for 
you to type commands at it. There are two versions of the Shell, the C>Shell and the Bourne 
Shell. Which character you get as a prompt (% or I) depends on which Shell is listening to you. 

We use the C-Shell, whose prompt is the sign in all our examples, but refer to it simply as 
the ‘Shell’ for simplicity’s sake. The Bourne Shell’s prompt is the ‘I* sign. The Shells are ' 
described in the chapter Ustng the Shell and in more detail in Part Two of this manual. You 
can also refer to the UserU Manual for the Sun Workstation pages on esh for the C*Sheli and on 
sh for the Bourne Shell. 

Now try the following; at the ‘tutorial^’ prompt, type: 

tutorial^ echo Hello there. 

Hello there, 
tutorial^ 

Don’t forget to press RETURN (also called a carriage-return) after the command, or nothing will 
happen. If you think you’re being ignored, press RETURN, and something should happen. We 
won’t mention this again, but don’t forget to press RETURN at the end of each line. 

The first word you typed to the ‘tutorial^’ prompt on the command line is the Sun system 
command echo. Echo does what it says, it ‘echoes’ or displays whatever follows it. When you 
type something to the ‘tutorial%’ prompt, the first word is always a command, which is also 
called a program. At this point, you are asking the Shell to look for that command and execute 
it. 

Now substitute your name in place of yourname in the example below: 

tutorial^ echo Hello yourname 
Hello ... 
tutorial^ 

Always separate a command from whatever follows by a space. Now try: 
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tutorial^ echo This is fun. 

This is fun. 
tutorial^ 

These are very simple examples. What follows a command is an argument Often this argu¬ 
ment is the name of a file or filename^ but in the simple example above^ it^s merely some text. 

If you want to compile a program written in the 0 programming language, for instance, you 
type: 

tutorial^ cc dats.e 
tutorial% 

Here the command is cc, the O compiler program. The argument to cc is a file called dats.e, 
containing the program's source text. 

You can name a file almost anything you want, but limit yourself to alphanumeric characters 
and the period Other characters such as the asterisk («), slash (/), and question mark (!) 
have special meanings when the Shell reads them. These special characters called metacharac- 
ters arc described later. 

There is one more thing that you can type on the command line after the *tutorial%’ prompt. 
This is called an option or flag argument Type it after the command, but separate the two by a 
space. Flag arguments modify the command. For example, if you want to suppress the load 
phase of the compilation of your program data.c and produce an object file, you type the cc 
command with the -c option: 

tutorial^ cc -c data.c 
tutorial^ 

Sun system commands usually have several options. 

Here’s a good opportunity to open up the U$er*$ Manual for the Sun Workstation to learn more 
about commands and about the user’s manual itself. The user’s manual contains information 
on most of the commands used in this tutorial. Turn to the cc pages and glance through them. 
You first see NAME, which gives you the command name as you type it at the Shell prompt 
*tutorial%’ and a brief phrase describing what the command does. Here, you see that cc is the 
‘C compiler.’ Next you see the SYNOPSIS, which shows the command line format and all the 
options. Yes, there are plenty of options for the C compiler. Most commands do not have this 
many however. 

Following is the DESCRIPTION, which explains in more detail what the command does. OPTIONS 
lists and describes the flag arguments. The remaining entries,EXAMPLE, FILES, SEE ALSO, DIAG¬ 
NOSTICS and BUGS provide additional information. 

If you’re interested in the wealth of information that the user’s manual provides, turn to the 
front of the manual and read on about the Sun system manuals in general to become familiar 
with the other reference sources. 

Note that important terms and command names in the text of this tutorial are printed in ital¬ 
ics, cc for example, and options in bold, like -c. In the exercises, bold face type like this 
indicates what you should type at your workstation. 

In general, when you type characters to the Sun system, they are gathered up until you type 
RETURN or a newline (also called LINEFEED). Up to the point you type RETURN, you have the 
opportunity to correct typing mistakes — you can back up over characters or words, or you can 
kill the entire line typed so far and start over. Once you have typed a RETURN, though, the line 
is passed on to whatever program you asked for (or maybe none at all if you misspelled the 
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program’s name). 

If you make a mistake typing the command name, and refer to a non-existent command, you 
will be told. For example, type ‘whom’: 


tutorial/^ whom 
whom: not found 
tutorial^ 


Clearly, ‘whom’ is not a command. Of course, if you inadvertently type the name of some other 
command, it will run with more or less mysterious results. 

The Sun system handles the keyboard and screen in full-duplex — it has full read-ahead, mean¬ 
ing that you can continue typing even while the system is displaying output on the screen. Of 
course, this means that what you type in as input is all mixed up with what the system displays 
— this may or may not bother you. However, what you type is saved up and interpreted in 
correct sequence. 

Try one more command; type the who am i command: 


tutorial^ who am i 

tutoriallevan console Jun 28 14:19 

tutorial^ 


The first name, ‘tutorial,’ is the system hostname; the second is the user’s login name, ‘evan’ in 
this case. 

Briefly, what’s happening when you run a program on the Sun system by typing the command 
name and pressing RETURN is this: the executing program takes input or data and produces out¬ 
put or results. A program usually expects to read the input from your keyboard, which is called 
the standard input, and the program usually writes its output to your workstation called the 
standard output. You can change these standards by redirecting the input and output to come 
from and go to other places, such as files, line printers, and so. This is explained in Using the 
Shell. 


1.2. What to Do If Something Goes Wrong 

Sometimes your system may not respond correctly. Here are two brief sections on what to do. 

1.2.1. Special Keys and Control Characters 

If you make a typing mistake, and see it before you press RETURN, there are several ways to 

recover using the following keys and control characters. You can also use some of these charac¬ 
ters to start and terminate programs. Glance over the list now to become familiar with them. 

DEL Called the erase character, DEL* backs up over and erases the previously typed char¬ 

acter . Successive uses of DEL erase characters back to the beginning of the line, but 
not beyond. 

"U Called the kiU character, "U erases the entire line you just typed.^ If the line is 

fouled up, type a and start over. 


^ On older keyboards, use the BACKTAB key as the DEL key. 
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This wipes out the previous word you typed. (A word is a sequence of characters 
delimited by space(s) and/or tab(s).) 

*C "C aborts or interrupts a currently running program. Use *C to stop a long prin¬ 

tout, for example. (Programs, like editors, can either ignore *C altogether or be 
notified when it is typed instead of being terminated.) 

"S This stops output from a running program. It is useful for preventing text being 

displayed from zipping off your workstation screen. 

"Q resumes output from a program whose display was suspended with "S. 

"O This throws output away without interrupting the program. 

The Quit character quits a program and saves an image of that program in a file 
called core. This is mostly used by programmers debugging programs. 

Tab Tabs are used freely in the Sun system source programs. If your terminal does not 
have the tab function, use the stty command (described in the user^s manual) to turn 
tab characters into spaces during output, and to be echoed as spaces during input. 
Tabs are set every eight columns. 

You can find out what the control characters are anytime with the stty command: 

tutorial% stty all 

new tty, speed 9600 baud; tabs 

ert 

erase kill werase rpmt flush Inext susp intr quit stop eof 

‘Z/“Y X ‘\ ^S/*Q 

tutorial^ 

Some of these, like "Z, are explained later on. 

I.2.2. Things That Go Bump in the Night 

Sometimes you can get into a state where your workstation or terminal acts strangely. For 
example, you may not be able to move the cursor, your cursor may disappear, there is no echo¬ 
ing of what you type, or typing RETURN may not cause a linefeed or return the cursor to the 
left margin. Tiy the following solutions: 

• First, type *Q to resume possibly suspended output. (You might have typed "S, freez¬ 
ing the screen.) 

• Another possibility is that you accidentally typed a NO SCRL key (also called SET UP/NO 
SCROLL on some terminals) on your keyboard. This also freezes the keyboard like typ¬ 
ing a *S. Try typing "Q, which toggles you back to proper operation if you did indeed 
type the NO SCRL key in the first place. 

• Try typing *C to interrupt the currently running program. 

• Next, try pressing the LINEFEED key, followed by typing ‘reset’, and pressing LINEFEED 
again. 

• If that doesn’t help, try logging out and logging back in (see Logging Out). If you are 
using a terminal, try powering it off and on to regain normal operation. 


* We use the convention vhstever ’ to mean controLwhatever — that is, hold down the CCH- 
TROL (or CTRL) key while typing a whatever character, ‘*D’ means hold down the CONTROL key 
while typing either ‘d’ or ‘D\ 
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1.3. Changing Your Password — the ‘passwd’ Command 

Passwd is the command that changes your password or installs one for you if you don’t already 
have one. Passwd is interactive so that when you type paaswd, it prompts you for input as fol¬ 
lows: 

tutorial^ passwd 
Changing password for evan 
Old password: zzzzxx 
New password: zzzzzz 
Retype new password: zzzzzz 
tutorial^ 

The system doesn’t echo what you type (shown by the x’s and r’s above), but it does ask you to 
type your new password twice to prevent typographical accidents and to provide better secu¬ 
rity. You will have to provide a reasonably long password unless you are persistent. 


1.4. Logging Out 

When you have finished your login session, there are several ways to log out. One way is to use 
the logout command: 

tutorial^ logout 
tutorial login: 

You can type an end-of-file indication, (the EOF character). Your system responds: 

tutorial% ("D) logout 
tutorial login: 

Finally, you can also change users directly with the login command and another login name: 

tutorial% login jerry 
Password: 

Last login: Mon Jul 18 07:50:22 on ttypO 
Sun UNIX 4.2 UNIX (Berkeley beta release) (GENERIC) #8: Wed Oct 23 13:45:52 PDT 1983 
tutoriaI% 

Try these logout methods now. 

Note that if you are using a terminal, it is usually not sufficient just to turn off the terminal to 
log out. Most Sun systems do not use a time-out mechanism, so you’ll still be logged in unless 
you logout explicitly. 


1.5. What is the Shell? 

As discussed earlier, after you log in and the *tutorial%’ prompt appears, a utility program 
called the Shell listens to what you type. In general, what you type to the Shell is a command 
line. A command always consists of the command name, such as the cc, which compiles C pro¬ 
grams. This is always the first thing on the line. This command name can be followed by 
optional arguments, such as the -c option or a filename. A command’s arguments are 
separated from the command, and from each other, by spaces and/or tabs. The Shell searches 
for the command in several well-known places, starts up the command, and passes the 
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arguments on to it. When the command has completed its job, the Shell regains control and 
again listens to what you type. 

Most commands are simply executable programs that the Shell looks for, but some commands 
are ^built-in' to the Shell, and the Shell interprets such commands directly. The Shell has many 
other capabilities, which are detailed in the user^s manual in the eth (C*Shell) and $h (Shell) 
entries. These are the two main Shells that you can run. 

The Shells are different for all but the most simple terminal usage. For instance, the C>Shell 
has history and alias features, which greatly enhance its power when used interactively. The 
C'Shell also supports a set of job-control facilities. See the reference material on Shells in Fart 
Two fpr more detailed information. 

1.5.1. Login Profile 

When you log in to the Sun system, you are logging in to the C-Shell. The Shell looks for files 
called .login and .cshrc. If there are such files in your home directory^ (described later) it runs 
any commands it finds in them. 

You only execute the .login file when the Shell is called up as part of the process of logging in. 
A sample .login file is: 

setenv EXINIT ’set noai wrapmargin=8’ 

set path=(. / /bin /usr/bin /usr/local /usr/ucb /usr/hosts) 

set mail=(/usr/spooI/mail/$USER) 

We won’t explain now what all these entries mean; see Using the C-Shell in Part Two for 
details. 

The file .cshrc is executed any time the Shell is invoked; for example, when you start or fork a 
new Shell. You’ll find that “rc" is a part of several such files, .mailrc for example. The “rc” is 
related to the phrase “run command,” and is used for any file that contains start-up informa¬ 
tion for a command. A sample .cshrc file is; 

if (I ITprompt) exit 
set history=36 
alias If Is -F 
alias cursor echo ’*[[s’ 
alias pq ’Ipq -P’ 

alias tutorial cd supplements/tutorial 

The history and alias entries are described later. Again, see Using the C-Shell for more details. 

1.6. The File System 

Sun system files are arranged in a hierarchy of directories. This hierarchy resembles an inverted 
tree structure: the file system begins at the root directory and branches to the limits of the 
available mass storage. Root is the name of the directory at the ^beginning’ of the file system. 
It is represented by a slash * / ’. Do not be confused by the two meanings of * / 
name of the root and a separator in filenames. Root contains references to files and subdirec¬ 
tories which contain other files and subdirectories and so on. Each directory is thus like a node 
on the tree — directories contain files (which contain data) and subdirectories (which contain 
files). Here is a picture which makes this clearer: 
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Figure 1-1; File Hierarchy Structure 

You can either move to another directory to work on the files held there, or you can gain access 
to those files from where you are, but you need to know where you are and what the direction 
or pathname is to the directory you want. If you are in /«sr for example, and want to work on 
a file in evan, then you need specify only the relative pathname as the directories are on the 
same branch. Look at this as a sort of ^how to get there from here* situation. If you are in n$r 
and want to gain access to something in /6in, you need to indicate the absolute or full pathname, 
which specifies ‘how to get there from the system root.* 

You can always find out where you are in this structure. Use the pwd (print working directory) 
command and type: 

tutorial^ pwd 

/usr/evan/intro 

tutorial^ 

to get your current or working directory. Here we are in /usr/evan/intro. There is a special 
notation that indicates, among other things, the current directory. This is the *.* or ‘dot*. 
Two dots .* means the parent directory, that is, the directory that the current directory (*.*) is 
a subdirectory of. This convention is constant wherever you are in the directory hierarchy. 

The initial slash 7’ response to the pwd command above names root, and successive 

slashes separate directory names. Here the current working directory is intro, which is a sub¬ 
directory of the directory evan, which is in usr, which is in 7’* The pwd command displays the 
full pathname to your directory. 

Your system administrator sets up your account by creating a directory, normally using the 
same name as your login name. This is called your home directory. Everytime you log in, your 
working directory will be set to your home directory. You own your home directory. This 
means you have full permission to read, write, or destroy its contents. You can also create new 
files and subdirectories within your home directory as needed, and do with them as you please. 
Access to files that others own is carefully controlled. 

There are two kinds of directories, system directories and user directories. System directories 
contain files and subdirectories that apply to the whole system. You and your fellow users can 
make user directories as needed as we show below. We describe how to do this later. For 
example, earlier you saw a user directory for Evan, /usr/evan. There can be lots of user direc¬ 
tories; it depends on how big the system is and on how many people can use it. You can have 
/ usr/henry for user Henry, and / usr/gang, for a particular project*s user directory, for example. 

There are also system directories, such as /bin, which holds most of the executable system com¬ 
mands, /etc which contains system directories, and /usr, which contains other directories. Your 
login name, encrypted password, and other information are contained in the passwd file in the 
/ etc system directory for instance. 
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That*8 enougli detail — let*8 move on to how you can use files and directories. 


Changing to Other Directories with ‘cd’ 

To look at other directories, use the ed (change working directory) command. If you’re in your 
home directory now at IusTjevany and you want to change to the /etc directory, type: 

tutorial^ cd /etc 
tutorial^ 

You’ve moved to /etc. If you then check your working directory with pwd, you’ll see: 

tutorial% pwd 
/etc 

tutoriaI% 

A cd command without any argument always returns you to your home directory. So if you get 
lost, type cd to get home: 

tutorial^ cd 
tutorial^ pwd 
/usr/evan 
tutorial^ 

And to change to the directory directly above the one you are currently in, type: 

tutorial^ cd • • 
tutorial% 

Try changing to some of the other directories noted above, such as /bin. 


1.6.2* What Files Do I Have — the ‘Is’ Command 

You can see what a directory contains using the U or iist’ command. See what files are con* 
tained in the root directory ^/\ Type the U command: 

tutorial^ Is / 

bin etc mnt sys usr 

boot lib pub testfile vmunix 

dev lost+ found stand tmp 

tutorial^ 

You see several columns of files and directories. Try changing to some of these directories and 
using 1$ to list the contents. 

Now change back to your home directory and use U to list files there. 

tutorial% cd 
tutorial^ b 
tutorial^ 

You don’t have any files in your home directory so Is doesn’t list anything. There are, however, 
some ‘hidden’ files, which the Is command with the -al option reveals. First try: 
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tutoriaI% b 
total 14 

drwxr-xr-x 2 evan 32 Mar 12 20:31 . 
drwxi^xr-x 12 root 240 Jul 7 15:22 .. 
tutoriai% 

The -a option lists *air files. The -1 asks for a iong* listing, for without it, only the filenames 
and subdirectory names are listed. Detaib on what ail the parts of the -I listing mean are pro¬ 
vided later. You’ll also notice here that you can combine flags as a sort of shorthand. 

Again, the is your home directory, and the your parent directory or /usr. 

There is another variant h -F, which marks which files contain executable programs, which files 
are directories, and which files are symbolic links (link a file or directory to another file or direc> 
tory). Try listing the contents of the root directory with the -P option: 

tutorial^ b ~P / 
bin/ 
boot* 
dev/ 

tutorial^ 

An entry without any following mark is a simple file. Those entries marked with an asterisk 
sign **’ are executable. Those marked with a slash character are directories and contain 
more files or subdirectories. Those marked with an *at’ sign are symbolic links. 

1.6.3. Making Directories with ^mkdir’ 

Let’s assume you now want to create some subdirectories to hold documentation and related 
memos for a customer demonstration of your new product. These will be user directories in 
/tfsr/ evan. Return to your home directory and make sure you know where you are: 

tutorial% cd 
tutorial% pwd 
/usr/evan 
tutorial^ 

Use the mkdir command to create (or *make’) directories for this project: 


etc/ mnt/ sys/ usr/ 

lib/ pub/ testfile vmunix^ 

lost-h found stand/ tmp/ 


MO 
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tutorial^ mkdir docs letters 
tutorial^ cd docs 

tutorial^ mkdir specs priceJist prod.announce 

tutorial^ Is -1 
total 3 

drwxi^xr-x 2 evan 24 Aug 19 09:12 price.list 

drwxr-xivx 2 evan 24 Aug 19 09:12 prod.announce 

drwxr-xr-x 2 evan 24 Aug 19 09:12 specs 

tutorial^ cd ../letters 

tutorial^ mkdir meet .min memos 

tutorial^ Is -1 

total 2 

drwxr>xr-x 2 evan 24 Aug 19 09:15 meet.min 

drwxr>x]>x 2 evan 24 Aug 19 09:15 memos 

tutorial^ cd 
tutorial^ 


The file system hierarchy here looks like: 


,7P\. 

evan 

/ \ 

letters docs 



meet.min memos specs price.list prod.announce 


Figure 1-2: Sample File Hierarchy 


I.6.4. Removing Directories with ^rmdir’ 

Use rmdir to remove directories. The directory must not contain any files or subdirectories if it 
is to be removed. For example, try to remove the Utters directory: 

tutorial% rmdir letters 

rmdir: letters: Directory not empty 

tutorial^ 

What happened? The Utters directory still has subdirectories in it. To remove it, you have to 
clear it out first with: 

tutorial^ rmdir letters/meet.min letters/memos letters 

tutorial^ 

Rmdir also lets you know if you try to remove a non-existent directory: 
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tutorial^ rmdir void 

rmdir: void: No such file or directory 

tutorial^ 


1.6,5. Copying Files with ‘cp’ 

As you know from your programming experience, the easiest way to write a program is to start 
with a copy of another program and develop it from there. To make a copy of another file, use 
the cp (copy) command on the jetcjkotU.equiv file: 

tutorial% cp /etc/ho8t8.equiv hosts.machines 
tutorial^ 

This copies hosts.equiv file in the jttc directory into a file called hosts.machines in your current 
working directory. Use this simple command to make as many copies of any file you want. 

Check your current working directory with the U command to see what it now contains. 

tutorial% b -1 
total 6 

drwxr-xr-x 5 evan 512 Aug 19 09:12 docs 

-rw-r-r^ 1 evan 480 Aug 19 09:23 hosts.machines 

tutorial% 

Remember the order of the cp command: cp copies the first file (or ^argument') to the second: 

tutorial^ cp thb that 
tutorial^ 

To copy the same named file into your own directory, mention the filename twice: 

tutorial^ cp /etc/ho8t8.equiv ho8ts.equlv 

tutoriaI% 

This puts a copy of the file called hosts.equiv into the current directory. 

If the second argument is an existing directory, you can use cp to copy the file named as the 
first argument into that directory and retain the same filename. It^s a little faster too. 

tutorial% cp /etc/ho8t8.equiv • 
tutorial% 

This copies /etc/hosts.equiv into your current directory; the *dot' ( . ) again stands for the 
current directory. 

You can copy a file into another file in your current directory or into one of your subdirectories 
as follows: 

tutorial^ cp /etc/ho8t8.equlv docs 
tutorial^ 

Or you can copy as many files as you need into a directory: 
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tutorial% cp docs/specs docs/price.list « 

tutorial% k -1 

total 

drwxr-xr-x5 evan 

512 

Aug 19 09:28 docs 

-rw-r—r- 1 evan 

480 

Aug 19 09:27 hosts.equiv 

-rw-r—r~ 1 evan 

480 

Aug 19 09:23 hosts.machines 

-rwxr-xr-x 1 evan 

24 

Aug 19 09:29 price.list 

-rwxr-xr-x 1 evan 
tutorial^ 

24 

Aug 19 09:29 specs 


Several words of warning when using cp: 

There isn^t any warning if you try to copy a file to another that already exists. The exist¬ 
ing file is written over, and you lose that version. 

If a file is protected from being written on for security reasons, or if you try to copy into a 
non-existing directory, you see the message: 

tutorial^ cp notes intro/lessons 
cp: cannot create intro/lessons 
tutorial^ 

And if for security reasons, you do not have read permission on the source file, write permis¬ 
sion to the directory, or if again, the source file or directory docs not exist, you see: 

tutorial^ cp data/today tomorrow 

Permission denied. 

tutorial^ 


I.6.6. Moving and Renaming Files with ‘mv’ 

To move files and directories from one place in the file system to another, use the mv (move) 
command. Mv renames a file. Moving differs from copying in that the original file disappears. 

Try using mv as follows: 
tutorial^ Is -1 

total 


drwxr-xr-x 

5 evan 

512 

Aug 

19 09:28 docs 

-rw-r—r~ 

1 evan 

480 

Aug 

19 09:27 hosts.equiv 

-rw-r—r~ 

1 evan 

480 

Aug 

19 09:23 hosts.machines 

-rwxr-xr-x 

1 evan 

24 

Aug 

19 09:29 price.list 

-rwxr-xr-x 

1 evan 

24 

Aug 

19 09:29 specs 

tutorial^ mv hosts^uiv ] 

boats 


tutorial^ k 

-I 




total 





drwxr-xr-x 

5 evan 

512 

Aug 

19 09:28 docs 

-rw-r-i^ 

1 evan 

480 

Aug 

19 09:27 hosts 

-rw-r—r- 

1 evan 

480 

Aug 

19 09:23 hosts.machines 

-rwxr-xr-x 

1 evan 

24 

Aug 

19 09:29 price.list 
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-rwxr-xr-x 1 evan 24 Aug 19 09:29 specs 
tutorial^ 

The file hoits.equiv has been renamed hosts. Note: If you move a file to a name that already 
exists, the second file contents are removed without warning: 

tutorial% mv hosts hosts.machines 


tutorial^ Is 

-1 



total 

drwxr-xr-x 

5 evan 

512 

Aug 19 09:28 docs 

-rw-r-r- 

1 evan 

480 

Aug 19 09:27 hosts.machines 

-rwxr-xr-x 

tutorial^ 

1 evan 

24 

Aug 19 09:29 specs 


If the target file is write-protected, mv asks you if you really want to write over the file. If you 
respond with y (yes), the file is moved. Otherwise, nothing happens. 

To move a file from one directory to another, make the second argument to mv the name of the 
target directory, if the target directory exists: 

tutorial% Is -1 
total 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 

-rw-r—r~ 1 evan 480 Aug 19 09:27 hosts.machines 

-rwxr-xr-x 1 evan 24 Aug 19 09:29 specs 

tutorial^ mv hosts.machines docs/specs 

tutorial% Is -1 

total 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 

-rwxr-xr-x 1 evan 24 Aug 19 09:29 specs 

tutorial^ Is -1 docs/specs 
total 1 

-rw-r—r— 1 evan 480 Aug 19 09:27 hosts.machines 

tutorial^ 

You can move as many files as you like. 

You can also move an entire directory to another name, but unlike files, you can only move 
directories if the second name does not already exist. See the user^s manual on mv for details on 
all the facilities. 

You can’t move or rename a file that doesn’t exist. You’ll see the message: 

tutorial^ mv illusion delusion 
mv: cannot access illusion 
tutorial^ 


1.6.7. Removing Files with the *rm* Command 


The rm command removes files from a directory. See what is in one of your directories, and 
remove a file of little importance: 
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tutorial% cd docs 
tutorial^ Is -1 docs 
total 3 

-rw-r^-r- 1 cvan 

drwxr-xi^x 2 evan 

drwxr-xr-x 2 cvan 

tutorial^ rro hosts^uiv 
tutorial^ Is -I docs 
total 2 

drwxr>xr-x 2 evan 

drwxivxivx 2 evan 

tutorial^ 


480 Aug 19 09:28 hosts.equiv 
24 Aug 19 09:12 price-list 
512 Aug 19 09:45 specs 


24 Aug 19 09:12 price-list 
512 Aug 19 09:45 specs 


Again, like the cp command, you can work on more than one file at a time. And if any file is 
write-protected, rm asks you whether you really want to remove a file. Responding y tells rm 
‘yes,* and rm removes the file. Typing n or simply typing the RETURN key prevents rm from 
removing the file. Even if you own the file and have read permission on it, you cannot remove a 
file from a directory if you don*t have write permission on that directory. 

If you are worried about removing files that you really don*t want to remove, use the -i option 
to rm to get an ‘interactive* prompt on every file. There is also the -f option that ‘forces* the 
rm command to remove a file, even if it is write-protected. 

With —r (recursive) option, the rm command searches down the directory tree, removing all files 
it finds. When a subdirectory is empty, rm then removes that subdirectory. This command 
does this for every file in every subdirectory (and so on) that it finds in the specified directory. 

Make copies of some of the files in /tisr or etc and try these options. Use the U •F command to 
copy text files, not executable files or directories. 

Caution: There are several special characters called ''metacharac¬ 
ters^^ in the Sun system. Well describe them in more detail later, 
but for now be careful about using the metacharacter with 
^Wm^% and especially with the —r recursive option. 

tutorial^ rm —r • 
tutorial^ 

removes EVERYTHING from the current directory on down as does the rm ~r . command, so be 
careful! 

Trying to remove a non-existent file results in: 

tutorial^ rro nobody.horoe 
rm: nobody .home non-existent 
tutorial^ 

You may have a file with non-ASCn characters in its filename, perhaps from a typographical 
error. Try rm -• or rm -r to remove it. 
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1.7. Security 

If you are worried about all the freedom that the Sun System provides to copy files, change 
directories, and such, rest assured that it also supplies a security^ system to control access to files 
and directories. For every file and directory, there are three classes of users who may have 
access, and for each of these classes, there are three ‘permissions,^ allowing or prohibiting access 
to a particular file. 

The three classes are: 

1. Owner — the person who created the file. 

2. Group — the group of users who share ownership of a file. (This is set up in the 
letclpa$Bwd file along with your login name and in the fctclgroup file.) 

3. Public — all other system users. 

For each of these classes, the three permissions are: 

1. Read — allows reading the file. 

2. Write — allows changes to the file. 

3. Execute — allows listing files in a directory, and execution of programs and Shell 
scripts. 

Consider some of the files and directories from before: 


drwxr-xr-x 

5 evan 

512 

Aug 19 09:28 docs 

-rw-r-i^ 

1 evan 

480 

Aug 19 09:27 hosts.machines 

-rwxr-xr-x 

1 evan 

24 

Aug 19 09:29 specs 


Here^s how you interpret all that stuff at the beginning of the lines. Consider the docs direc> 
tory: 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 

The ‘drwxr-xr-x* order shows ‘user, group, public.* The first ‘rwx* belongs to the user ‘evan* 
who has read-write-execute permission. The second ‘r-x* belongs to the ‘group* which has read- 
execute permission for the file. The third ‘r-x* belongs to the ‘public* which also has read- 
execute permission. Hyphens indicate the absence of a permission. The leading ‘d* indicates 
that it is a directory. 

1.7.1. Changing File Permissions with ^chmod’ 

Suppose you need to change the permissions on a file or directory so others can access them to 
do work. The chmod command changes those permissions or the ‘mode* of the file. There are 
four common modes that set the permissions. The following numbers are based on the octal 
number format. (Read more about chmod in the user*s manual if there doe3n*t seem to be any 
rhyme or reason.) 

• 644 indicates ‘-rw-r-r-*. The owner can read and write the file, but everyone else can 
only read it. 

• 755 indicates ‘rwxr-xr-x*. The owner can read, write, and execute the file, and everyone 
else can read and execute it. 

• 600 indicates ‘rw-* for a file (use 700 for a directory). The owner can read and 

write the file, and everyone else has no access. 
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• 444 indicates ‘r-r-r~\ Everybody can only read the file. 

Suppose you have some directories like *evan^ above, and you decide that only you should be 
able to read and write the doc$ directory, while everyone else cannot do anything. As it is now, 
the permissions are: 

tutorial^ b -I 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 
tutoriaI% 

Using the chmod command with the 700* permission, type: 

tutorial^ chmod 700 docs 
tutorial^ b -1 

drwx- 5 evan 512 Aug 19 09:28 docs 

tutorial% 

The 755’ permission is the default. 

You can’t change the mode of a file that doesn’t exist, nor can you change the mode of a file 
that you don’t own (remember ownership is indicated by the login name, ‘evan’ in the example 
above). 



1.8« Finding Out What Is Going On In the System 

You now have a basic understanding of your personal directory. Let’s take a step outside and 
see what the system can do for you. 

1.8.1* Who Is Logged On — the ‘who* Command 

See who is currently logged in with the who command: 

tutorial% who 
evan console Jan 16 09:11 
smith ttypO Jan 16 09:25 
tutorial^ 

The first entry is the user’s login name, the second entry is the system’s idea of what terminal 
the user is on, and the date and time is when the user logged in. 



1.8.2. Who Is Using the Network — the ‘rwho’ Command 


Rwho produces output similar to the who command, but for all systems on your local network. 
(The ‘r’ in rwho may seem cryptic, but it refers to those ‘remote’ hostnames that make up the 
rest of your local network.) Rwho is somewhat more particular than who however, in that it 
only reports on machines that have been active during the previous 60 minutes. If a user has 
not typed to the system for a minute or more, rwho reports this idle time in minutes in the 
rightmost column. A typical example is: 


tutorial^ rwho 



bob 

krypton :ttyp2 

Aug 


< etc. > 


joe 

venu8:con8ole 

Aug 


2 14:19 :03 
2 08:57 :27 
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marty paperittypO Aug 2 14:34 

tutorial^ 

Try the rwho command now to see who else b logged in on your network. 

Use the -a option to show everyone logged in, even if they arc not doing any active work. 


1.8.3. What Is the Network Status — the 'ruptime’ Command 

To check on the status of each system on the local network, use the ruptimt command. For 
example, a typical display from the Sun Microsystems network is: 

tutorial^ ruptime 


tutorial 

up 4:07 

1 user. 

load 

1.32, 

0.92, 

1.15 

betasun 

down 12+ 

14:40 





datsun 

up 4:07, 

1 user. 

load 

1.02, 

0.80, 

1.19 

sundial 

down 3+ 19:41 





titan 

up 4:05, 

2 users. 

load 

1.42, 

0.55 

1.18 


tutorial^ 

Normally the list is sorted alphabetically. Try this now on your system to see what everyone 
else is up to on your local network. See the user^s manual page for details. Note that here as 
with the rwho command, you must have the proper network configuration to get similar results. 

I.8.4. What Is the Date and Time — the ‘date’ Command 

Another useful command is the date command. Use this one if you have forgotten your watch 
at home. Try typing: 

tutorial^ date 

Fri Aug 19 10:15:08 PDT 1983 

tutorial^ 

and you get back not only the day and date, but also the time (that is, the system^s idea of 
what time it is). 

What Is the System Doing — the ‘ps’ Command 

Because this is a multi-tasking system, you can run several processes at once. (Well explain 
how to do this in Using the Shell.) When you do execute several commands at one time, you 
may need to know how far along they are. Use the ps (process status) command for this: 

tutorial% ps 

PID TTY STAT TIME CMD 
2025 02 R 0:01 ps 
tutorial^ 

This lists the processes belonging to you. PID indicates the ^process identification* number, 
TTY the terminal from which the process was started, STAT the state of the process, TIME 
the amount of computer time used so far, and CMD the command line that was typed to ini¬ 
tiate the process. 
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As you can see, there is one process in operation, the p$ process. 
With the ~x option, the p$ command displays all your processes: 


tutorial^ ps -x 


PID 

TTY 

STAT 

TIME 

CMD 

2028 

02 

S 

0:05 

ps 

2029 

tutorial^ 

08 

S 

0:05 

-csh (csh) 


Looking at the TTY column, note that in our example, you are logged on twice, once on tty02 
and once on ttyOS. Pa displays all processes associated with the user, not those associated with 
a particular workstation or terminal. 

Also try the pa command with the -ax option, which tells about ‘alF processes going on in the 
system. For example: 


tutorial^ ps —ax 


PID 

TTY 

STAT 

TIME 

COMMAND 

0 

f 

D 

2:33 

swapper 

1 

f 

I 

0:20 

/etc/init - 

2 

f 

D 

< etc. > 

0:08 

paged aemon 

5535 

CO 

S 

0:22 

-csh (csh) 

5696 

tutorial^ 

CO 

R 

0:03 

ps -ax 


I.8.6. Who’s Doing What — the ‘w’ Command 

If you get really nosey, try the w command to check whether there is anyone else logged in to 
your system and what that user is doing. Try this now and decipher the abbreviations using 
your knowledge of what the who and pa commands display. 

tutorial^ w 

12:19pm up 1 day, 18:54, 1 users, load average: 1.36, 1.22, 1.24 
User tty loginO idle JCPU PCPU what 

evan console 7:08am 2:31 2:16 w 

tutorial^ 

Here, dearly, the user *evan^ is logged in to the ^console^ and running the tr command. 

It’s also polite to run w before using write to write a message to someone (we explain this in the 
Communicationa chapter). Check what your colleague is doing first; it’s not nice to interrupt 
him in the middle of editing a file, for example. 


Revision D of 7 January 1984 


1-19 




O : 





! 

i 







Chapter 2 


Working with Files 


This chapter explains how to view your files and how to do simple operations on them. First, 
yon need a file to play with. Step through the instructions to prepare the luBrUihluniiB system 
file for the exercises that follow. The lutrllibluniU file converts units of measure and is some¬ 
thing of a hodge-podge, but it^s interesting to glance through. The instructions do not provide 
explanations of each command here, but you can always refer to the user's manual if you're par¬ 
ticularly curious about something at this point. By the end of this tutorial, you will be able to 
look back at this sequence and understand each step. 

Remember: If you make a typing mistake, use the DEL key to back up and correct the error. 
You can also type RETURN to which the system will respond ^Command not found' or 
‘Unmatched'. You can then retype the command. 

1. Be sure you are in your home directory with c(fc 

tutorial^ cd 
tutorial^ pwd 
/usr/evan 
tutorial^ 

2. Use the ktad command with the —30 line option on the /usr/Ublunita file, and redirect 
it to a file called star there: 

tutorial^ head -30 /uar/lib/units > 8tart.here 
tutorial^ 

3. Use the tail command with the -30 line option on the f uerf libf units file and append 
the results to the starthere file: 

tutorial^ tail -30 /uar/lib/units > > start.here 
tutorial% 

4. Use the tr (translate) command to change tabs to spaces in the start.here file so the file 
is easier to work with. The sequence of keystrokes here is a little bit tricky; after the 
first apostrophe, type the TAB key. This jumps the cursor one tab space, and you can 
continue typing in the rest of the command line, putting spaces between the apos¬ 
trophes. Here you also create your practice file called playfile: 

tutorial^ tr * ' ’ ’ < start.here > playfile 

tutorial% 

5. Check your home directory with the Is command to see that the playfile is there. 
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tutorial% Is 
playfile start.herc 
tutoriaI% 

The original 8tart,here file is there too. 

Yon are now ready to begin working with a file of data. 

2.1. Paging Through a File with ‘more’ 

The more command reads one or more text files and displays the contents a screenful at a time. 
Try it on playfUcy for instance: 

tutorial^ more playfile 
/ dimensions 
m *a* 
kg *b* 
sec ♦c* 

< etc. > 
wey 40 bu 
weymass 252 Ib 
—More—(47%) 

The ‘47%’ message informs you what percentage of the current file’s characters has been 
displayed so far. A 0% percentage may be displayed if you are looking at a very large file 
because more displays only integer percentages. 

To display one more line at the bottom of the screen, press the RETURN key. To see the next 
screenful, press the space bar. To see the next 11 lines, type ‘d’ or "D. 

To terminate more, simply type ‘q’ for ‘quit’ and you return to the ‘tutorial%’ prompt: 

strike 2 bu 
surveyfoot british-ft 
surveyorschain 66 ft 
< etc. > 

Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
—More—(97%) 
tutorial% 

More has options that help you get to a specific line or text pattern in a file. For instance, to 
get to line 45 in the file playfUey type: 

tutorial% more +45 playfile 
tablespoon 4 fldr 
teaspoon 4|3 fldr 
tesla weber/m2 

< etc. > 
weymass 252 lb 
Xunit 1.00202-13m 

k 1.38047-16 erg/degC 
tutorial% 
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To start displaying text at the first line which contains a string, ^circle* for example, type: 

tutorial% more +/’circle’ play file 
.. .skipping 

degree 1|180 pi>radian 
circle 2 pi>radian 
slug lb-g-sec2/ft 

< etc. > 
weymass 252 lb 
Xunit 1.00202-13m 
—More—(97%) 

This is one of the few instances of prefixing an option with a ‘-I- ’. As you saw earlier, most 
options are prefixed with a 

There is another command, the cat command (for ^concatenate^ or join), which also displays a 
file on the screen. However, if your file has more than one screenful of data (and yours does, as 
it has two workstation screens or 60 lines), it zips off the screen before you can see it. Try using 
eat now just to see what it does: 

tutorial% cat play file 

< zip!! > 
tutoriaI% 

We simply mention cat here along with the other file viewing commands and describe its more 
useful capabilities later in Using the Shell. 

2.2. Browsing Through a File with ‘view’ 

With the more command, you can page through a file by typing the space bar or move through 
a file line by line by typing RETURN. When you want to scroll forward and backward through 
a file, use the view command: 

tutorial% view play file 
/ dimensions 
m *3* 
kg *b* 

< etc. > 
span 9 in 
spat 4 pi sr 

“playfile” [Read only] 60 lines, 959 characters 

Use the following characters to move the screen: 

*D scrolls down one half screen 
*U scrolls up one half screen 
"F moves forward one screenful 
"B moves backward one screenful 

Remember, the means *Hold down the CTRL key while typing the letter.’ 

To exit or ‘quit’ viewing the file, type ;q, which is echoed at the bottom of the screen and 
returns you to the ‘tutoriai%’ prompt. 
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You see in Creating and Editing Fites — The *vi’ Editor that the vi editor uses these same 
characters. 


2.3. Look at the First Few Lines of a File with ^head’ 

When you need to check the first few lines of a file, use the head command. This is one of the 
commands you typed to make the playfile. Head gives you the first ten lines if you donH specify 
how many you want. Here let’s specify the first three lines, for instance: 

tutorial^ head -3 playfile 
/ dimensions 
m *a* 
kg ♦b* 
tutorial% 

Head also accepts a list of filenames and will then display the first few lines from each with a 
special header to indicate the filename. You have two files, playfile and start.here, so let’s use 
those. 

tutorial% head -4 playfile 8tart.here 

—=> playfile 
/ dimensions 
m *a* 
kg 

sec *c* 

=*=> start.here <== 

/ dimensions 
m *3* 

kg ♦b* 

sec ♦c* 

tutorial% 

Here you have two separate files, showing the first four (if there are four) lines of each. Each 
file has a separate entry and the filename is enclosed in =s=> <== as shown. 

2.4. Look at the Last Few Lines of a File with Hail’ 

The tail command is similar to the head command, but displays the tail-end of the file. Again, 
if you do not specify a number, you see the last ten lines. For example, to see the last three 
lines of the file, type: 

tutorial^ tail -3 playfile 
weymass 252 lb 
Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial^ 

Precede the number given to tail by a minus sign to indicate that the last x number of lines are 
to be displayed. If you precede the number with a plus sign, tail shows all the lines from that 
specified to the end of the file. 
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tutorial^ tail +55 playfile 
tun 8 barrel 

water .2249112.54 kg/m2-sec2 
wey 40 bu 
weymass 252 lb 
Xunit 1.00202>13m 
k 1.38047-16 crg/degC 
tutorial^ 


2.5. Counting Characters^ Words, and Lines in a File with ^wc’ 

When you need to count the lines of source code in a program or the number of words in a 
document, use the wc (word count) command. Try it now on your file. For example: 

tutorial^ wc playfile 

60 147 959 playfile 

tutorial^ 

We provides the number of lines, words, and characters in the file. If you only want one of the 
three counts, use the -1 option to count lines, the —w option to count words, and the -c option 
to count characters. Try trc with the —w option to count the number of words: 

tutoriai% wc -w playfile 
147 playfile 
tutorial^ 

PlayfUe has 147 words. 


2.6. Searching for Patterns in a File with ‘grep’ 

Grep searches one or more files for lines which contain striiigs of a certain pattern. Such lines 
are said to match the pattern. 

Grep looks for a pattern which consists of a fixed character string. It is also possible to describe 
more complex patterns, called ^regular expressions.* (Grep stands for ^global regular expression 
print,’ if that helps^ 

To search for a character string, give prep a fixed character string. To find the string ‘inch’ in 
the file, for instance, t 3 rpe: 

tutorial^ grep inch playfile 
tutorial^ 

The ‘tutorial^’ prompt returns for the next command, indicating that there is no match in this 
case. This can be a common occurrence; it is often a matter of trying several differents aspects 
of a command to get the desired result. 

Now try to find the string ‘mercury’ in the file. Type: 

tutorial^ grep mercury playfile 
mercury 1.33322+ 5 kg/m2-sec2 
hg mercury 
tutorial^ 
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This shows that there aure two such strings in the file. 

Or^ if you are not sure which file contains the desired string, scan more than one file at the same 
time: 



tutorial% grep mercury play filo at art.hero 
playfilermerc ury 1.3^322+ 5 kg/m2-sec2 
playfile:hg mercury 

start.here:mercury 1.33322+ 5 kg/m2-sec2 

8tart.here:hg mercury 

tutorials 


Here you see that grep labels ^mercury* with the name of the file in which the string b con* 
tained. 

If the filename is not important, suppress it with the —h (omit file header) option. Now consider 
the example as: 

tutorial^ grep —h fuss playfile 8tart.here 
fuzz 1 

c 2.997925+ 8 m/sec fuzz 
au 1.49597871+ 11 m fuzz 
mole 6.022169+ 23 fuzz 
e 1.6021917-19 coul fuzz 
fuzz 1 

c 2.997925+ 8 m/sec fuzz 

au 1.49597871+ 11 m fuzz 

mole 6.022169+ 23 fuzz 

e 1.6021917-19 coul fuzz 

tutorial^ 


This gives you several references to the string ‘fuzz’. 

When you want to find a specific string and not a lot of extraneous references, type it exactly as 
you want to find it. For instance, if you are generally interested in finding references to ‘sur¬ 
vey’, type: 

tutorial^ grep survey playfile 

surveyfoot british-ft 
surveyorschain 66 ft 
surveyorslink 66|100 ft 
tutorial^ 


You see three words containing the string ‘survey’. However, if you want to find the specific 
string ‘surveyorschain’, type that string: 

tutorial^ grep surveyorschain playfile 

surveyorschain 66 ft 

tutorial^ 


If the pattern you’re looking for contains spaces, ‘2 pi’, for example, surround it with quote 
signs ( ’ ) so that it forms one argument. 

tutorial^ grep ’2 pi’ playfile 
circle 2 pi-radian 
tutorial^ 

A space is used to separate arguments, so a pattern which also contains spaces must be enclosed 
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in quotes. 

If you want to find all the lines except those that match the string, use the -v (for invert) 
option. We'll leave this up to you to experiment with. 

At times you want to find a string regardless of whether it is in upper or lower case. Use the -i 
grep option to ‘ignore case'. As the plagfile is almost solely lower case, here's an example of 
using grep with the —i option to find the string ‘bool' in the file option$w,c: 

tutorial^ grep -i bool optionsw.e 
#define OPT^OOL 1 

case OPT_BOOL: optb_destroy(ip->oi_data); 
struct optb_data 

optsw_booKstruct optionsw ♦optsw; int line, left; char *label 
optsw_bool(struct optionsw ’<>optsw; struct rect r; char *label; 

This finds all the lines containing ‘booF in cither upper or lower case. 

Use the -n (number) option to show the line numbers of lines that match the string or pattern, 
for example: 

tutorial% grep -n fuss playfile 
15:fuzz 1 

17:c 2.997925+ 8 m/sec fuzz 
19:au 1.49597871+ 11 m fuzz 
20:mole 6.022169+ 23 fuzz 
21:e 1.6021917-19 coul fuzz 
tutorial^ 

This helps when you are using an editor or some other command to process the file using line 
numbers. 

2.6.1. Regular Expressions in Text Patterns 

To search for more complex strings than simple fixed character strings, give grep a pattern (or 
template) of the text to search for. For example, ‘find all words ending in ing,' or ‘all 4-digit 
numbers appearing at the end of a line.' Such a pattern or template is called a ‘regular expres¬ 
sion.* 

Grep uses certain characters called metacharacten that represent something other than them¬ 
selves and have a special meaning. We describe these below with examples, but what you need 
to know now is that sometimes you may want to use these metacharacters to represent them¬ 
selves; that is, if you want to find a string with a dollar sign ‘S', you need to remove its special 
metacharacter significance. (‘$' matches the end of a line.) To remove the special significance of 
metacharacters, precede them with the backslash ‘ \ ' escape character. In this case then, grep 
considers the sign as a dollar sign, rather than the metacharacter that matches a line end. 

Also, enclose the regular expression in quotes. Single quotes ( ' ) are safest, but often double 
quotes ( " ) are sufficient. 
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2.8.2. Match Beginning and End of Line with ^ and $ 

To match a string at the beginning of a line, use the * ’ character. For example, to find the 
string ‘fuzz’ at the beginning of a line, type: 

tutorial^ grcp play file 

fuzz 1 

tutorial^ 

The * * ’ finds only those lines starting with the word ‘fuzz’. 

To match a string at the end of a line, use ‘ I ’. For instance, to find ‘fuzz’ at the end of a line, 
type: 

tutorial% grep ’fuzsl’ playfile 
c 2.997925+ 8 m/sec fuzz 
au 1.49597871+ 11 m fuzz 
mole 6.022169+ 23 fuzz 
e 1.6021917-19 coul fuzz 
tutorial^ 

The ‘ I ’ selects only those lines ending with the word ‘fuzz’. 

Preceding an expression by ‘ ^ ’ and following it with ‘ I ’ as in: 

tutorial^ grep ’~fuis$’ playfile 
tutorial^ 

selects only those lines consisting of ‘fuzz’, and nothing else. This is called an 'anchored match’ 
because it is anchored at a specific place on a line. Here, grep doesn’t find any string to match. 

If you put the ‘ ’ and ‘ S ’ characters in places other than the beginning of the pattern, or the 
end of the pattern, respectively, they lose their special meanings. 

Find blank lines in a file with the expression This pattern finds lines which have only a 
newline, and no other text. It doesn’t locate spaces, tabs or other non-printing characters on 
the line. Use it with the -n line number option to specify where those blank lines are: 

tutorial^ grep -n playfile 

12 : 

14: 

26: 

28: 

tutorial^ 


2.6.3. Matching Any Character with 

Use the period (or ‘dot’) metacharacter to match any character at all. So the string ‘ w... ’ 
selects all strings starting with the letter ‘w’, and having three more characters. To find such 
strings at the beginning of a line, use ‘^w... ’. To find such strings at the end of a line, use the 
expression ‘w...$’. Remember that spaces are counted as part of the string. 

As an example, ‘w...’ finds the patterns: 
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tutorial^ grep play file 

water .2249112.54 kg/m2-sec2 
wey 40 bn 
weymass 252 lb 
tutorial^ 

To find a real period at the end of a sentence, use the ‘ \ ’ escape character to remove any spe¬ 
cial significance. Thus, use the expression ^w...\.\ The period metacharacter never matches the 
newline at the end of a line. A consequence of this is that text patterns never match across 
lines; they only match within a line. 

2.6.4. Character Classes with [ and ] and — 

To specify a set of characters, enclose them in brackets, ]*. This matches any one of the char¬ 
acters inside the brackets. The expression ^^[abcxyz]* finds all lines beginning with *a^ or ^b^ or 
‘c’ or *x’ or ‘y’ or 

Use the hyphen character ‘ ’ to specify a range of characters inside *[ ]’, for example ‘*[a-cx-*]’. 

Here are the common regular expressions: 

Table 2-1: Common Regular Expressions 


Expression 

Translates to 

M 

all lowercase letters 

(A-Z) 

all uppercase letters 

m _ 

all digits 


If you are looking for four-character strings that begin with ‘F or ‘L’ and contain only letters, 
use the pattern '[Ll][arr][a-s][a-£]*, assuming that only the initial letter can be in uppercase. 

In the example ‘"[arcx-z]* note that the ‘ " * metacharacter (match the beginning of the line) is 
outside the brackets. If it’s inside *[ it inverts the selection process. So the expression * 
[*L!][a-z][a-z][a-z] ’ specifies all four-letter words that begin with something other than *L’ or ‘I’, 
and the pattern *''[''a-z]’ finds all lines except those that begin with lowercase letters. 

It should be emphasized that ranges of characters pertain to the ASCII character set, so that 
the pattern ‘[A-z]’ gets you ail upper and lowercase letters and the characters [ ) " « ‘ • 

This sort of confusion occurs most often when dealing with digits. The pattern ‘[1-30]’ does 
NOT mean ‘numbers in the range one through 30’; it means ‘digits in the range 1 through 3, or 
O’. It is the same as a pattern that looks like ‘[1230]’ or ‘[0-3]’. 

If you really wish to include ‘ - ’ in the class of characters, it isn’t necessary to escape it so long 
as it is positioned such that it won’t be confused with a range specification. For example, a 
hyphen at the beginning of the pattern stands for itself: [-ab] means the pattern ‘ - ’ or ‘a’ or 
‘b’. The same is true for the characters ‘(’ and ‘]’. 

2«6.5. Subsets of Regular Expressions 

Here are some possible situations using regular expressions. You can find all but blank lines 
from a file by: 
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tutorial^ grcp -v ’*$’ play file 
/ dimensions 
m 

kg ♦b* 

< etc. > 

k 1.38047-16 crg/degC 
tutorial^ 

The regular expression finds all the blank lines, and the —v saves all the other lines and 
ignores the blank lines. Fi^re out what this really docs; it gets rid of lines that arc really 
blank. 

You can delete the apparently blank lines as well, with: 

tutorial^ grep -v *$* playfile 
/ dimensions 
m *3* 
kg *b* 

< etc. > 

k 1.38047-16 erg/degC 
tutorial^ 

The regular expression says, in effect, ‘look for a beginning of line, followed by any number of 
spaces (including no spaces), followed by an end of line.’ 

If the apparently empty line contains tabs as well as spaces, replace the simple space in the 
above regular expression with an expression that says ‘space or tab’, shown here by the ‘*1’ 
which means type "I. This is the tab character, or TAB key. You used this tab character with 
the tr command to set up the playfile. Your screen shows: 

’-[ ]*«’ 

Also add the -n option to list the line numbers of the blank lines. 

tutorial^ grep -n "!]♦$* playfile 

12: 

14: 

26: 

28: 

tutorial^ 


2.7. Sorting Text Files with ‘sort* 

To order the contents of a file alphabetically or numerically, use sort. There are many options 
which control the sort order. The most useful are described here. For more details, refer to the 
sort utility description in the User^s Manual for the Sun Workstation, 

Sort does not expect fields on a line to appear in a fixed columnar layout. It just works on 
fieldsj which are normally separated by spaces or tabs (you can specify any field-separator you 
want). This provides a typewriter oriented approach, rather than the historical punched card 
orientation. 

Consider a file with a random list of classical music composers and their birthdates. Sort it as 
follows: 
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tutorial^ sort composert 
Franz Haydn 1732 
Franz Schnbert 1797 
Gustav Mahler 1860 
Johannes Brahms 1833 
Wolfgang Mozart 1756 
tutorial^ 

Sort orders and displays the list alphabetically by first names. You can tell sort to sort on the 
last name too. Each line in the file is considered to consist of fields, the fields being separated 
by spaces. To get your file in order of last name, tell the program to skip one field, the first 
names, and then start sorting: 

tutorial^ sort -f 1 composers 
Johannes Brahms 1833 
Franz Haydn 1732 
Gustav Mahler 1860 
Wolfgang Mozart 1756 
Franz Schubert 1797 
tutorial^ 

This works as long as there are only two fields, and no middle initials, for example. Plan your 
sort accordingly to account for the number of fields. See the user^s manual page on sort for 
more details. 

For numerically ordered sorting in this example, skip two fields before starting to sort. Type: 

tutorial% sort -b +2 composers 
Franz Haydn 1732 
Wolfgang Mozart 1756 
Franz Schubert 1797 
Johannes Brahms 1833 
Gustav Mahler 1860 
tutorial% 

The -b option tells sort to ignore blanks in all fields on the line. Without this option, each field 
is considered to start immediately after the end of the previous field, so the spaces between the 
last name and the birthdate count as part of the birthdate. Also, sort considers ASCII charac¬ 
ters, and the character for space has a lower value than any of the characters for the digits 0 
through 9. 

To restrict the effect of ignoring blanks to only the numeric field, use the b option in this way: 

tutorial^ sort +2b composers 
Franz Haydn 1732 
Wolfgang Mozart 1756 
Franz Schubert 1797 
Johannes Brahms 1833 
Gustav Mahler 1860 
tutorial% 

Here the +2b is called a *fiag,' rather than an option, and gives the same results as before. 
However, in other situations, you will use one or the other depending on the desired results. 

If you need to sort a file by numbers that do not have the same number of digits, tell sort that 
the characters in the field are to be treated as numbers, and to sort according to the arithmetic 
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values of those numbers. Add the letter n (for numeric) after the number of the fields skipped 
before the field that is to be treated in this way: 

tutorial^ sort +2n +1 composers 

Johannes Brahms 4 

Gustav Mahler 9 

Franz Schubert 9 

Wolfgang Mozart 41 

Franz Haydn 104 

tutorial^ 

Using the numeric option implies that spaces are ignored, so you don^t have to use the b option. 
Mahler and Schubert composed the same number of symphonies, and they are listed in alpha¬ 
betical order by ordering that field (by +1). 

To tell sort to reverse the order of sorting of a field, add the letter r (for reverse) after that 
field: 

tutorial^ sort +2nr -f 1 composers 

Franz Haydn 104 

Wolfgang Mozart 41 

Gustav Mahler 9 

Franz Schubert 9 

Johannes Brahms 4 

tutorial^ 

Reversing the sorting order with r is not restricted to numeric sorting, although that*s where 
you’ll usually use it. 

To save the output in a file, use the —o (for output) option followed by the name of the file that 
is to contain the output. You can give all the filenames to join sorted files. And if your input 
files are already sorted, you can simply merge them by using the -^m (for merge) option. Refer 
to the user’s manual for more details on these options, and then experiment with them. The 
-m option saves sort some work by indicating that the files are already sorted, and need only 
be merged. 

You can also get rid of possible duplications of names in files with the -u (for unique) option. 

Normally sort assumes fields are separated by spaces or tabs, but they can be separated by 
something else. Use the -t option to tell sort this. For example: 

tutorial^ sort ~t: +5 /etc/passwd 

tutorial% 

sorts the jetc!passwd file, which uses the colon character as its field separator. 


2.8. Finding Differences Between Files with ^difiP 

When you need to tell what differences there are between one version of a file and another, use 
the diff utility. For example, if you want to find the new ski team members between last year’s 
and this year’s lists, type: 
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tutorial% diff •kiteain8.82 •klteams.SS 

2c2 

< Shelley Curtis 

> Norman Travers 
7d6 

< Harry Cuthbertson 
lOalO 

> Karen Stevens 
tutorial^ 

This indicates that there are three changes to the file. The second line has changed (*2c2*)^ but 
it is still the same line number. The first file (or old version of the line in this case) is preceded 
by a *<’, and the second file (the new version in this case) is preceded by a *>’. The *7dd’ 
shows that line 7 of the original file has been deleted. And 40al0^ indicates the third change^ 
the addition of a new line after line 10 in the original file. 

Try the diff command on your two files, plaiffile and startkere: 
tutorial^ diff playfile •tart.here 

The results zip off the screen pretty quickly (we’ll explain how to manipulate that display for 
examination later), but you see that there are lots of differences. Try the diff command on some 
other files and interpret the results. 

There are several options to the diff command that you should read about in the user’s manual. 
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You haye seen how the Shell is the interface between you and the various Sun system com¬ 
mands. Here we describe some more Shell facilities that you should experiment with to do your 
tasks. There is also a description of how to use SunWindows to facilitate working on several 
jobs at once in the window system. 



3*1 • Redirecting Standard Input and Standard Output 


When you run a program on the Sun system, it usually expects some input (data) and produces 
some output (results). This input or standard input is the place from which a program expects 
to read its input, usually your keyboard. The output or standard output is the *file* to which 
the program writes its results, usually your workstation screen. 

You can change these defaults by telling the Shell that the standard input for a command is to 
be taken from a file, or that the standmxl output of a command written to a file. This process 
is called ‘redirection^ and uses those and characters you saw in some of the examples in 
the chapter on Working With Files, 

You can also take the standard input of a command directly from the standard output of 
another command, and similarly to direct the standard output of one command straight to the 
standard input of the next command. This feature is called piping^ and a string of commands 
hooked together in this way is called a pipeline. 

If a filename argument to a command is prefixed by the character, the standard output of 
that command is redirected to that file instead of going to your workstation screen. For exam¬ 
ple, the Is command displays a list of the directory contents on your workstation screen, but if 
you use *> files' as a redirection indicator, the command line puts the contents listing of the 
current working directory into a file called pleSf which is placed into the current directory. Try 
this now from your home directory as indicated in the following example:. 


tutorial% cd 
tutorial% Is -1 > files 
tutorial^ Is -1 
total 202 

-rw-r-p~ 1 evan 110 Aug 

-rw-r-r- 1 evan 959 Aug 

-rw-r—r- 1 evan 959 Aug 


6 14:03 files 
6 11:20 playfile 
6 11:18 start.here 


tutorial^ 
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You can also see that your directory now contains three startkeret andT^^e#, which 

contains the long h listings of all the ffles. If the named file to which output is redirected 
doesn't already exist, it is created. 

You can now view the file at your leisure, or change it around for any useful purposes of your 
own. Look in your new files file with the more command: 



tutorial^ more files 
-rw-r—r— 1 evan 
-rw-r-r~ 1 evan 
-rw-r-r^ 1 evan 
tutorial^ 


0 Aug 6 11:40 files 
059 Aug 6 11:20 play file 
959 Aug 6 11:18 start.here 


You have your current directory listing, including files, which is created before the command 
runs. 

Be careful, though, because if the file to which the Standard Output is redirected already exists, 
the previous contents of the file are lost! The 0-Shell has a noetobber variable that you can set 
to prevent this from happening. Read about this in the csh description in the user's manual. 

If you don't want to lose the contents of an existing file, but want the output of a command 
appended to the end of it, prefix the filename with two right chevron signs *>>'. You used this 
notation before to prepare playfile. As another example, type: 

tutorial^ pwd > > files 
tutorial% more files 

-rw-r—r- 1 evan 0 Aug 6 11:40 files 
-rw-i^-r— 1 evan 959 Aug 6 11:20 playfile 

-rw-r-r~ 1 evan 959 Aug 0 11:18 start.here 

/usr/evan 
tutorial^ 



which prints the name of the current working directory at the end of the contents listing of the 
directory. 

In many ways *>>' is safer to use than *>’ because it doesn't destroy previous information. 

Just as the ‘>’ character or the ‘>>’ sign redirects the Standard Output of a command to a 
file, you can redirect the Standard Input for a command to come from a file, instead of your 
workstation keyboard. Prefix the file name with a left chevron sign *<'. For example: 

tutorial^ mail < gossip 
tutorial^ 


takes mail messages from the file gossip, created previously by an editor. 

You'll use redirection of Output more often than redirection of Input because a lot of commands 
are designed to take their input from files anyway. 

If you do not specify any files, commands use the Standard Input. The eat command, which we 
mentioned briefly in Working with Files as a file viewing command, is one; 


w 
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tutorial^ c&t 

Type what you want here. 

Cat then displays It on the Standard Output, 
your workstation screen. 

D 

Type what you want here. 

Cat then displays it on the Standard Output, 

your workstation screen. 

tutorial^ 

Typing a ''D tells eat that you have finished. 

There are many commands which only act on the Standard Input, that is, what you type at 
your keyboard. If you want these to work on a file instead, you have to redirect the input to be 
from that file; for instance: 

tutorial^ cat < files 

-rw-r-r- 1 evan 0 Aug 6 11:40 files 

-rw-r-r- 1 evan 959 Aug 6 11:20 playfile 

-rw-r—r-- 1 evan 959 Aug 6 11:18 start.here 

/usr/evan 

tutorial^ 

concatenates the contents of the file called filet to the Standard Output. 

Also consider the tr (translate) command, which you can also redirect to operate on a file as 
input instead of the Standard Input: 

tutorial^ tr a-s A-Z < files > FILES 
tutorial^ more FILES 

-RW-R~R~ lEVAN 0 AUG 6 11:40 FILES 
-RW-R-R- lEVAN 959 AUG 6 11:20 PLAYFILE 

-RW-R~R~ lEVAN 959 AUG 6 11:18 START.HERE 

/USR/EVAN 
tutorial^ 

As you saw above, the cat command can use the Standard Input or, with redirection, a file as 
input. What cat really does best is indeed what it says, it ‘concatenates^ or joins files with the 
appropriate redirection. For example, to join two files, files and playfile^ to form a third file 
mess that contains both, type: 

tutorial^ cat files playfile > mess 
tutorial^ more mess 
-rw-r—r— 1 evan 0 Aug 6 11:40 files 

-rw-r—r— 1 evan 959 Aug 6 11:20 playfile 

-rw-r—r— 1 evan 959 Aug 6 11:18 start.here 

/usr/evan 
/ dimensions 
m *a* 

< etc. > 

Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial^ 

You then have the mess file that contains files followed by playfile. 


Revision D of 7 January 1984 


3-3 





Using the Shell 


Beginner's Guide 


To add one file to the end of another, use eat and the double chevron redirection symbol *>>\ 
If you want to add the contents of playple to the end of fUcMf type: 

tutorial^ cat playfile > > files 
tutorial^ more files 

-rw-r-r- 1 evan 0 Aug 6 11:40 files 
-rw-T^-r- 1 evan 959 Aug 6 11:20 playfile 

-rw-r^-r“ 1 evan 959 Aug 6 11:18 start.here 

/usr/evan 
< etc. > 

Xunit 1.00202'13m 
k 1.38047-16 erg/degC 
tutorial^ 

You then have two files, the original playfile file and a new filea file that contains followed 
by playfile. 

Be careful that you do not use the same filename when redirecting both Standard Input and 
Standard Output. The first thing that happens when you use *>’ is that the file it points to is 
created. If that file already exists and if there^s something in it, the contents are lost. For 
example: 

tutorial^ cat < now > then 
tutorial^ 

works, but in the following cases, the files are clobbered: 

tutorial^ cat < thisdata > thisdata 
cat: input - is output 
tutorial % 


or 

tutorial^ cat thisdata > thisdata 
cat: input thisdata is output 
tutorial^ 

The cat command warns you with ‘cat: input - is output' that something is wrong, but contin¬ 
ues to overwrite or clobber your file anyway. Another such problem occurs if you try: 

tutorial^ cat a b > B 
tutorial % 

which clobbers 6 before running cat. See the cah ‘noclobber’ option to prevent this. 


3.2. Connecting Processes with Pipes 

You can run the Standard Output of one process (or program) as the Standard Input of another 
process when you form a ‘pipeline.' 

Using the wc and who commands, and the ‘|' (vertical bar) ‘pipe' symbol, find out how many 
people are logged in: 

tutorial^ who | wc -1 
1 

tutorial^ 

Here who feeds its Standard Output to the Standard Input of the wc command, which counts 
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lines with the -I option. And yes, that number 1 is you, if you are the only one on your system. 

A pipeline is a flow of data that several programs (or processes) operate on in turn. If you write 
the sequence: 

tutorial^ b -1 /usr | grep evan | sort +3nr | Ipr 
tutorial^ 

you have a string of connected commands or a 'pipeline.* The Standard Output of the command 
to the left of the '|* becomes the Standard Input to the command on the right of '|*. 

Here the long U listing of files and subdirectories in /usr is passed to the grep command instead 
of to the default Standard Output, the workstation screen. Grep selects all lines containing the 
string 'evan* from its Standard Input, and sort sorts the fourth field of all those selected lines in 
reverse numerical order. 

Lpr routes its input to a printer, so you get a print-out instead of seeing the results on the 
screen. This, in fact, is the most common use of piping. Since all commands except Ipr provide 
output to the Standard Output, the only way to get a hard copy print-out of a file at the end of 
such a pipe sequence is to pipe it to lpr. 

You can type all the commands in the pipeline one at a time, but here the system does all the 
intermediate work for you, and it*s much quicker because you don*t have to wait for each com¬ 
mand to finish. 

Some commands are special. Ls does not accept the Standard Input because its 'input* is a 
directory whose contents are to be listed. You can only use Is as the first command in a pipe¬ 
line. The Ipr command does not write to the Standard Output, instead its 'output* is to a 
printer somewhere. You can only use Ipr as the last command in a pipeline. 

You can use both redirection of input and output with pipelines. 


3.3. Controlling Jobs 

Because the Sun operating system is a multi-tasking system, you can run more than one job or 
‘process* at a time. You can manipulate your jobs by running them in either the foreground or 
the background, stopping, suspending, or killing them as we describe below. 

3.3*1 • Foreground and Background Processes 

You saw what processes are running with the ps (process status) command. Everytime you ask 
the Shell to run a command, it runs that command as a separate process. The process which 
converses with your workstation is called a 'foreground* process because it is in the foreground 
of your attention. Normally, each command you type, or each pipeline of commands, runs as 
foreground processes, and they run at your workstation ‘while you wait.* 

This could mean a lot of waiting for processes to finish, so you can also run commands in the 
'background.* Your system prompt re-appears immediately after you type the command, and 
you can continue with another task while it completes. This is particularly useful for com¬ 
mands that take a long time to run. 
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3.^1.1 • Etunniiig Jbbs in the *&? 

To mn a command iu the background^ type mi ampersand *&* at the end: 

tutorial^ tori filea fis 
[112042 
tutorial^ 

The ‘[l]^ is the job number and the *2042* number reply is the PID (or process identity number 
you saw earlier with the p# command) that the operating system associates with the command 
you typed. Sometimes the process you put in the back^und calb up other processes which 
you don*t know about, but only the number for the primary (or parent) process is shown when 
you type the command. In this example, sort displays the sorted files on your screen. 

You can then type another command to have the Sun system doing sereral things for you at the 
same time. Or you can log off, and the background command continues running. 

Avoid haying too many things going on at the same time; your system has to play ringmaster in 
your multi-ringed circus, so it might end up taking just as long to complete all your tasks as if 
you had done them one by one at the keyboard waiting for the prompt each time in the fore* 
ground. 

One word of caution: if your background process is taking input from a file, don*t start another 
command, either in the background or in the foreground, which will modify the contents of that 
file. Results can be unpredictable. 

To ensure that your output goes to the right place and is not mixed up with other files or lost, 
redirect the output of the background command to a file: 

tutorial^ sort files > files^sorted & 

[1} 2043 
tutorial^ 

Now the output of your background command will not disturb you, or anyone else, who ia exe¬ 
cuting commands in the foreground. And you can view it at your leisure with more: 

tutorial^ more files-sorted 
-rw-r—r— 1 evan 959 Aug 6 11:18 start.here 

-rw-r~r— 1 evan 959 Aug 6 11:20 playfile 

/ constants 
< etc. > 
wey 40 bu 
weymass 252 lb 

tutorial^ 

Or you can pipe the results to the printer: 

tutorial^ sort files | Ipr & 

[1] 1043 1044 
tutorial^ 
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3.3.2. Stopping and Resuming Jobs 

If you start a foreground job, you can stop it temporarily with a and resume it later: 

tutorial% spell playfile > mispeil 
Z 

Stopped 

tutorial^ 

If you put a job in the background, you can stop it with a stop command: 

tutorial^ sort playfile & 

[2] 2345 

tutorial^ stop %2 

[2]+ Stopped (signal) sort playfile 

You need to type the job number prefixed by the after the 9top command to indicate which 
job to suspend if youVe running more than one. You can resume a stopped job later. 


3.3.3. Placing Jobs in the Background 

If you start a job in the foreground, and then decide you want to work on something else while 
it is completing, use the following sequence: 

tutorial^ spell playfile > mispeil 
Z 

Stopped 
tutorial^ bg 

[1] spell playfile > mispeil & 
tutorial^ 

Here you start running the tpeU utility, which finds those ubiquitous spelling errors, then you 
decide to work on something else, and stop it with "Z. Typing bg then puts that job in the 
background for completion. 


3.3.4. Bringing Jobs to the Foreground 

If you put a job in the background, and then decide you need it back in the foreground, use the 
following sequence: 
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tutorial^ spell play file > miipell & 

[11321 

tutorial^ Is -F > inydir & 

[2] 322 

tutorial^ who [ wc 
Z 

Stopped 

(3) 323 324 
tutorial^ jobs 

[1] - Running spell play file > mispell 

[2] Running Is -F > mydir 

[3] + Stopped who | wc 
tutorial^ fg %2 

Is -F > mydir ^ 

tutorial^ more mydir 

Typing the job$ command displays a job table to remind you which job is which. It also gires 
you the status: *+ ’ for the current job and for the previous job. 

The fg ‘foreground’ command brings the background job U -F to the foreground. Note that to 
bring a particular command to the foreground, you precede the job number with the sign. 
Note that you can also type the command you want to bring to the foreground; that is, in this 
example ‘%ls’ would mean the same thing as ‘%2’. You only need to type a unique part of the 
full command, hence the Is, and not the whole sequence. 

You can also use fg to restart a job previously suspended with ‘*Z’. 


3.3.5. Killing Jobs and Processes with ^kilP 


W 


If you start a command running in the background, and then change your mind for some rea¬ 
son, you can stop the process with the kili command and the FID. From the other example, we 
got 321, so to kill it you type: 

tutorial^ spell playfile > mispell & 

[1] 321 

tutorial^ kill 321 

[1] Killed spell playfile > mispell 
tutorial% 

You can also type kill to kill the process running as job number 1. 

A process can use several subprocesses called children. To kill them one by one may take some 
time. To stop them all, find the subprocess’ PlDs with the p$ command and stop them all with 
the same kili Some processes are clever enough to ignore the stop signal number that the sys¬ 
tem sends them. If this is the case, but you really want to kill a certain command, type: 

tutorial^ kill-9 321 

[2] Killed spell playfile > mispell 
tutorial^ 


The signal number 9 is a sure kill signal option, 
that’s either running in the background or stopped. 


You can also use kill 0, to kill everything 
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3.4. Recalling Previous Commands with ^history’ 

The C-Shell has a bnilt-in history mechanism to keep track of some number of the commands 
yon type. This is handy for re-executing long commands and for changing parts of and re- 
executing previously typed commands, 

You determine the number of commands by setting a variable called ^history* in your ,ctkre file 
with an editor: 

set history=^30 

After reading the chapter on the editor, come back to this part and create a xihrc file with the 
history option. A typical display from the history buffer is: 

tutorial% history 

1 Is 

2 cd /intro/lessons 

3 history 
tutorial% 

Here you clearly have not been logged on very long because youVe only typed three commands. 
Note that the history command abo appears as the last command. 

If the ^history* variable is set to 30, the history command displays the last 30 commands you 
typed during the current login session. 

The first thing to look at is correcting the previous command. If you mistype something, such 
as changing directories, and get the ‘No such file or directory* message, you don*t need to retype 
the whole cd command and pathname. Simply use the character to bracket the incorrect 
and correct spellings and make the substition as follows: 

tutorial^ cd /usr/evan/intro/lesona 
/usr/evan/intro/lesons: No such file or directory 
tutorial^ 

To correct this ‘lesons* typo, type: 

tutorial% "lesont" lessons" 
cd /usr/evan/intro/lessons 
tutorial^ 

or even just: 

tutorial^ "so"sso" 

cd /usr/evan/intro/lessons 

tutorial^ 

History echoes the command it is executing. 

The *"* characters act as delimiters to surround the two strings. The first string is the thing 
you want changed. The second string is the thing you want to change it to. The corrected 
command b echoed back at you. 

Use the history facility to see what happened to the commands: 


Revbion D of 7 January 1984 


3-9 





Using tlie Shell 


B^iiiner V Guide 


tutoFial^ historjr 

1 b -1 

2 cd intro/Iessons 

3 history 

4 cd /ttsr/evaiii/iiitro/lcsoiis 

5 cd /usr/evan/mtro/Iessons 
g history 

tutorial^ 

The two ed commands from the examples above, the erroneous one and the corrected one, now 
appear in the history buffer. 

To run the previous command again, simply type: 

tutorial^ !! 
history 

1 ls-1 

2 cd intro/Iessons 

3 history 

4 cd /usr/eyan/intro/lesons 

5 cd/usr/evan/intro/lessons 

6 history 

7 history 
tutorial^ 

To avoid typing out a long command line that you have run previously, type an exclamation 
mark in front of a unique number of characters from the previous command. For example, 
assume you want to re-run the ed command noted before. Use the M* character and ed to ask 
the Shell to search backwards through the history file for a command beginning with the letters 
‘cd\ 

tutorial^ led 

cd /usr/evan/intro/lessons 

tutorial^ 

You don^t have to to type the whole command name, just enough of the previous command to 
make it unique. So you can also type the cd command like this: 

tutoriaI% !c 

cd /usr/evan/intro/lessons 
tutorial% 

and it will do just as well. 

If you ask for a command that the Shell cannot find, an error message is displayed: 

tutorial^ bed 

xd: Event not found. 

tutorial^ 

You can also refer directly to a previous command in the hbtory file, by typing the exclamation 
mark followed by the number of the command in the history buffer. For example, you can re¬ 
run command number 1 in the buffer like this: 
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tutorial^ !1 
Is -1 

< output from the U command > 
tutorial^ 

The number must immediately follow the exclamation mark. 

Another version of ‘repeat a previous command^ is to use the dollar sign to refer to the last 
argument of the previous command: 

tutorial^ mv /usr/evan/intro/lessons/notes extra 
tutorial^ pr !$ | Ipr 
pr extra | Ipr 
tutorial^ 

As well as simply repeating a previous command, you can make changes to the command at the 
same time. Consider the history buffer after the last few changes: 

tutorial^ history 

1 ls-1 

2 cd intro/lessons 

3 history 

4 cd /usr/evan/intro/lesons 

5 cd /usr/evan/intro/lessons 

6 history 

7 history 

8 cd /usr/evan/intro/lessons 

9 cd /usr/evan/intro/lessons 

10 ls-1 

11 mv /usr/evan/intro/lessons/notes extra 

12 pr extra | Ipr 

13 history 
tutorial% 

You can see the substitutions that were made in previous commands. 

Assume that the file you want to move from Evan’s directory was actually the data file, not the 
notes file. To avoid all the tiresome typing of the whole pathname again, use the Shell substitu¬ 
tion capability: 

tutorial^ !ll»/note8/data 

mv /usr/evan/intro/lessons/data extra 

tutorial^ 

Note that this same syntax is used in the editors for making text substitutions. 

3.5. Substituting with ^alias’ 

The Shell also provides a method of making shorthand names or aliases for frequently used but 
long-winded commands. 

Assume that you are updating a series of plans for a large software project. Each plan and its 
related meeting minutes are in a separate directory named fmiscjmaster!projectjdocuments. 
The last element in the pathname is plana for project plan A, planh for project plan B, and so 
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on. Instead of typing these long pathnames everytime your group makes changes in a plan, 
define an alias in your .csArc file in your home directory: 

alias plana cd /misc/master/project/documents/plana 
alias planb cd /misc/master/project/documents/planb 
alias plane cd /misc/master/project/documents/planc 
alias pland cd /misc/master/project/documents/pland 
alias plane cd /misc/master/project/documents/plane 

Now you have some new commands, so all you have to do to change directory to one is type: 

tutorial^ planb 
tutorial^ pwd 

/ misc/rnaster/project/documents/planb 
tutorial^ 

You don^t even have to define five separate alias lines; one suffices if you use ‘\!$^ 

alias plan cd /misc/master/project/document8/plan\!$ 

The *\!l' notation refers to the last argument typed on the command line. The * \ * (escape) 
character prevents the from being expanded until a plan command is actually typed. Now 
you can change to the plane directory like this: 

tutorial^ plan c 
tutorial^ pwd 

/ misc/master/project/documents/planc 
tutorial % 

The C-Shell constructs plane out of the argument you typed, c, and the plan that was defined in J 
the alias. 


3.6. Using SunWindows 

To use SunWindows, you must have in your path in your Aogin file in your home 

directory, and you must have created the appropriate devices for it in the J dev directory. You 
only need to do this once on each machine. Your Aogin file might look something like: 

setenv EXINIT ’set noai wrapmargin=8’ 

set path=(. / /bin /usr/bin /usr/local /usr/suntool /usr/local/bin /usr/ucb /etc /usr/hosts) 
set mail—(10 /usr/spool/mail/$USER) 

To create the appropriate devices, set your userid to root, change directory to /detr, and run the 
Shell script MAKEDEV on winO and moute. That sequence is: 

tutorial% root 
Password: 
tutorial# cd /dev 
tutorial# MAKEDEV wInO 
tutorial# MAKEDEV mouse 
tutorial# "D 
tutorial^ 

You are then ready to use SunWindows. To start, type: 
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tutorial% suntoolt 

Your workstation screen turns grey and the arrow cursor that tracks the mouse motions appears 
in the upper lefthand corner. You always have one window open called the Root Window^ 
which contains the grey pattern you see on the screen now. This grey is the background for the 
tuntooU environment. 

You may have to circle the mouse on the pad several times in large, slow circles to orient it 
properly or to make the cursor to appear. The long side of the mouse should be parallel to the 
short side of the mousepad. 

To display a window, press the right or menu button on the mouse. You see the Root Manager 
menu similar to; 

Root Mgr 
New Shell 
New Graphics 

Exit _ 

Redisplay All 

Move the cursor to the New Shell box and release the button. Youll note that the item you 
select shows in reverse video. 

We use the word cursor here to mean the arrow that tracks the mouse movements. In general, 
pressing the button displays a menu and releasing the button puts the specified item into 
action. Also, when we say “Press,’* we mean press the button and hold it down until you have 
positioned the arrow cursor at the desired place. Sometimes all you need to do is click the but¬ 
ton, that is, press and release it immediately. We will make the distinction when necessary 
because the effects are different. 
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A window appears on your screen: 



Figure 3-1: Sample Window 


You can now use the window for whatever purpose you need, executing Shell commands or edit¬ 
ing a file for example. 

You’ll note that you have to keep the cursor in the window area to do work. If you move it to 
the grey area and try to type a command to the shell, for instance, nothing happens. 

3.6.1. Working with Windows — the Tool Manager 

There are several functions you can perform that facilitate your work, such as moving windows 
from one place to another, closing one down into its icon image, or uncovering an overlapped 
window. For these you’ll use the Toot Manager menu. Press the right mouse button, and select 
what you want to do on the Tool Manager menu: 

Tool Mgr 

Close _ 

Move _ 

Stretch 

Expose 

Hide 

RePisplay 
Quit _ 


To shrink a window tool to a small icon in the corner of the workstation screen, you use the 
Cloee function. The processes continue to run even though the window is closed. 
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To move or stretch a window, position the cursor in the name stripe (the black border at the 
top of the window) or on an outer window boundary, and invoke the Move or Stretch function. 
In these cases, additional action is required. You are prompted on the screen with: 

Press the left or middle button near the side or corner you 
wish to drag and hold the button down while dragging the 
bounding box to the location you want; then release the 
button. To cancel, press the right button now. _ 


To bring to the front of the window stack or expote the overlapped windows, use the Expose 
item. This brings the specified window to the front. Hide puts a window on the bottom of the 
stack. 

R^isplay repaints a window in case something was written over it. If several of the windows 
are been written over, use the Root Manager menu ReDbplay All to redraw all the windows 
you have open. 

To reopen a closed window, position the cursor over the icon shell and use the Open tool. 

There are faster ways to do several of the above maneuvers. We d^cribe them in Quick Tool 
Manager Functions. 

Use Quit to terminate a window. 

You can change your mind, as the screen shows: 

Press the left mouse button 
to confirm Quit. To cancel, 
press the right mouse button 
now. 


To get another window, simply position the arrow cursor on the grey area and press the right 
button again to call up the Root Manager menu to create a new Shell. The new window will 
overlap the first as shown: 


o 
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Figure 3-2: Overlapping Windows 

You can start something in one window, then move the mouse to another window, and type or 
use the mouse again without waiting for whatever you started in the first window to complete. 
You can also of course expose, hide, move windows, and so on to make the arrangement 
appropriate to whatever you are working on. In this figure we are editing a text file with one 
shelltool and listing a directory contents with the other. Both have been moved from their 
default positions to show more of the text. 

You will usually use the mouse buttons like this: 

• left — selecting objects 

• middle — adjusting selections to more or fewer objects 

• right — invoking menus 

If you change your mind after calling up a menu and indicating a function, simply move the 
arrow cursor off the menu and release the mouse button to cancel the command. 


3a6.2. Copying Text 

When you want to copy some text from one place to another in the same window or from one 
window to another, position the cursor at the start of the text you want to copy and click the 
left button. A small box marks the spot. 

Reposition the cursor at the end of the text and click the middle button to expand the box 
around the body of text you want to copy. 

Now position the arrow cursor in the window where you want the text to appear at the spot 
marked by the regular cursor. Press the right button, indicate Stuff with the arrow cursor and 
release the button. 
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Selection 

Stuff 


The text is copied to the new position: 



Figure 3-3: Copying Text 


Here we have copied a cd command to avoid having to retype the long directory name. You can 
of course also copy blocks of text within an editor. 

Note: You must be in insert mode to copy text if you are editing a file with the vi editor. You 
may copy a maximum of 200 characters. Beware that if you copy a shell command that 
includes a carriage return, your new line will be executed immediately as it will contain that 
carriage return too. 

Practice copying text a few times to learn the button sequence. 


3.6.3. Quick Tool Manager Functions 

You can quickly invoke several of the tool manager functions without having to bring up a 
menu by simply pressing one of the mouse buttons with the mouse cursor in the appropriate 
spot. These accelerators are described in the following table: 
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Table 3-1: Quick Tool Manager Functions 


Function 

How to Do It 

Open an icon 

Click the left button with the cursor over the icon 

Move a window or an icon 

Press the middle button with the cursor in the tool 
window's name stripe or outer boundary 

Expose a window 

Click the left mouse button with the cursor in the 
name stripe of the window you want to expose 

Help 

Type a question mark with the cursor in the name 
stripe of any window to display a message describ¬ 
ing possible actions 


If nothing happens, recheck the cursor position to be sure it is in an appropriate place — on a 
name stripe, border, or icon. 


3.6.4. Simple Graphics Demos 

Now try some sample graphics. Call up the New Graphics tool window through the Root 
Manager: 

Try the bouncing ball demo botmeedemo: 

tutorial^ bouncedemo 
Use to stop the demo. 

Also sample the simulated cruise through the galaxy jumpdemoi 
tutorial^ jumpdemo 

For informatin on more graphics tools, refer to the Veer *4 Manual on iuntooU, 


3.6.5. Quitting SunWindows 

To leave SunWindows, use the Root Manager to Exit. This closes all windows and termiantes 
the associated processes. 

Note: Be sure you complete everything you have started exiting SunWindows, especially any 
files you are editing. All processes left running are terminated without warning. 

3.6.6* Customizing SunWindows — the ,suntools File 

If you want several application programs or tools to start up automatically when you type sun* 
tools, put a .suntools file in your home directory. The ,suntools file works a lot like the .login 
file; it starts several processes in motion as soon as you type suntools. 
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If you want a .suntooh hie now, you can either learn how to create and edit a file to make your 
own by reading ahead to Creating and Editing Text File$ — the *vi^ Editor or by reading ahead 
to Copying FUe$ from Other Syotemo with Vcp * in Communeations, This latter section provides 
details on how to copy a file from someone else^s machine to your home directory. The latter is 
perhaps the easier of the two methods. In either case, run source on the new .suntooU file for it 
to be in effect. The command sequence for copying someone else*s file is: 

tutorial^ cd 

tutorial^ rep angeh/usr/henry/^untoob • 

tutorial^ source ^untools 

tutorial^ 

A sample .suntooU file for Models 100/150 with a Sun-1 video board is: 

shelltool 0 0 650 567 64 736 64 64 0 

clocktool 160 80 650 567 956 0 64 64 1 

shelltool 0 232 650 567 0 736 64 64 1 CONSOLE 

This automatically makes an open shelltool window, and puts a working clock and a console 
window represented as icons on your screen. 



Figure 3-4: Sample .suntools Set Up 

The first set of numbers represents the location and size of the open windows, and the second 
set of numbers represents the location and size of the closed windows’ icons. Here we automati¬ 
cally ca|l up one open window, a clock icon in the upper righthand corner of the screen, and a 
CONSOLE shell icon in the lower lefthand comer. In each set, the numbers represent the x coor¬ 
dinate, the y coordinate, the length, and the height respectively. The last single number indi¬ 
cates that the tools will either be “open” as in the case of the shelltool window or “closed” as in 
the cases of the clocktool and CONSOLE shelltool, which are represented as icons. 
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For the Model 120 with a Sun-2 video board, a sample .tuntooU file looks like: 


/usr/suntool/clocktool794 676 200 61 
/usr/suntool/shelltool 0 333 650 567 
/usr/suntool/shelltool 0 0 650 567 
/usr/suntool/shelltool 504 71 647 829 


1084 4 64 64 
1014 12 64 64 
944 12 64 64 
874 12 64 64 


1 


0 CONSOLE 
0 
0 


See the .tuntooU description in the C/ser’# Manual for details on what else you can do in your 
,9untool$ file. 
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Creating and Editing Text Files — the vi Editor 


The Sun system supports several editors, vi (pronounced Vee-eye^) ex (pronounced Wex’), ed, 
and 9td. This chapter provides the basics for learning to use the ‘display' or ‘screen' editor W, 
which is a screen-oriented version of tx. Many of the more useful operations that can be per¬ 
formed in vi call upon ex functions, so in learning vi, you're also gaining an understanding of ex. 
In addition, ex is based on the ed editor, but has many extensions and additional features. Here 
you learn about the top of the line, and a little bit about the others too. Refer to the Editing 
and Text Proceeeing on the Sun Workstation for more details. 

Vi displays a portion of your file on your workstation screen. You can move the cursor around 
on the screen to make changes by adding, deleting, or replacing text, and you can move the 
screen itself around to edit different parts of the file. 

Almost every key on the keyboard is a vt command. There are also combinations of the SHIFT 
key and the other keys, and combinations of the CTRL key and other keys. Note that when we 
say ‘A,' we mean uppercase ‘A'. Lowercase ‘a' means something different. 


4.1 • Command and Insert Modes 

There are two modes in vi, command mode and insert mode. In command mode, you can move 
the cursor around the screen, scroll the screen, search for patterns, save the file, and do other 
operations which don't involve entering fresh text. To enter new text into the file you must be 
in insert mode, which you get with the *a', ‘i', and ‘o' commands. You get out of insert mode 
by typing the ESC (ESCAPE) key (or ALT on some keyboards). The significant characteristic 
of insert mode is that commands can't be used, so anything you type (except ESC) is inserted 
into the file. If you change your mind anytime using vi, pressing ESC cancels the command you 
started and reverses to command mode. Also if you are unsure of which mode you are in, press 
ESC until the screen flashes or the bell rings; this means that you are back in command mode. 

Start working on your playfile. To use the vi editor, type: 

tutorial% vi playfile 
The screen displays something like: 
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/ dimensions 
m ‘a* 
kg ♦b* 

< etc. > 
spat 4 pi sr 

“playfile” 60 lines, 959 characters 
with the cursor at the upper left hand corner. 

Now practice using the following keys to move the cursor, scroll the screen, and so on. 

4.2. Moving the Cursor 

There are several ways of changing the position of the cursor. You can move it character by 
character, word by word, sentence by sentence, forward, backward, from one screen to another, 
and on and on. We present the more useful ways here, but youll want to read further on vi to 
learn all the facilities. 


4.2.1. 1, h, k, j — Forward, Backward, Up, and Down 

To position the cursor a character at a time, use the four keys h, j, k, 1, which move the cursor 
as follows: 

h move the cursor one character to the left 
1 move the cursor one character to the right 
k move the cursor up one line 
j move the cursor down one line 

After a little practice, you'll find these easy to use because they're right under your fingers. 

The BACKSPACE key on your workstation keyboard has the same function as you can use 
it to move the cursor to the left. Typing *h’ without holding the control key works too. Both 
"J and "N move the cursor down to the next line. The LINEFEED key has the same function 
as " J. Test out all these possibilities on your workstation or terminal. 

You can move the cursor several lines or characters by pressing the key repeatedly, or you can 
hold down the key as you go for an automatic repeat. (Some terminals have a key marked 
REPEAT. If you hold this key down while typing some other character, that character is 
repeated until you let go.) Use these features when you have long distances to move the cursor. 

You can give the cursor positioning commands a preceding count to move the cursor a specified 
number of characters or lines. For instance, ^81' moves the cursor eight characters to the right. 

If the cursor is towards the end of a line, and you move it down to a shorter line, then the cur¬ 
sor is placed at the end of that shorter line. However it reverts to its original horizontal posi¬ 
tion on any line that is long enough. 

Moving the cursor down one line past the last line of the screen scrolls the screen up one line. 
You cannot go past the end of the file, there is no wrap around to the beginning. Moving the 
cursor up one line from the top line of the screen scrolls the screen down one line. 

Some of the vi commands use the bottom line of the screen, to display the command or its 
result. The bottom line initially shows the filename and length. 
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4«2.2. 0 and $ — Move to Beginning or End of Line 

For horizontal motions along the lines, three useful functions are: 

move cursor to first non-blank character of line 
0 move cursor to the real beginning of line 

$ move cursor to end of line 


4.2.3« M| L — Move to Home^ Middle, and Last Line on Screen 

Three more basic cursor movements are: 

H home 
M middle 
L last 

The H command homes the cursor onto the top line of the screen, M moves the cursor to the 
middle line of the screen, and L moves it to the last line of the screen. H and L take preceding 
counts, for example, 3H moves to the 3rd line on the screen, 2L moves to the second line from 
the bottom. If you have a key marked HOME on your terminal, this usually achieves the same 
as the H command. 


4.2.4. w, b, e -— Moving by Words 

To move over the text a word at a time instead of only character-by-character, use the com¬ 
mands: 

w move forward to beginning of next word 
e move to end of this word 
b move back to beginning of word 

If you are already at the beginning of a word when you type a ‘b’, the cursor goes to the begin¬ 
ning of the previous word. If you are at the end of a word when you type an ‘e’, the cursor 
moves to the end of the next word. 

A ‘word’ is anything consisting of letters, digits and underscores, surrounded by anything which 
is not a letter, a digit or an underscore. This definition covers identifiers in most programming 
languages, so the commands are useful for editing both programs and documentation. 

If your file is shorter than the screen, on-screen lines not present in the file are indicated by the 
tilde character (~) to avoid confusion with blank lines in the file. 

All the commands ‘w’, ‘b’, and ‘e’, move past the end of a line. If you use them to move past 
the upper or lower limits of the screen, the lines scroll up the screen accordingly. 

You can use a preceding count with these commands, so ‘5w’ moves the cursor forward five 
words, for example. 
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4.2.5. (, )> {> } — Moving by Sentences and Paragraphs 

The and y commands move the cursor over sentences, to the beginning of the next sen¬ 
tence, and to the beginning of the previous sentence. These commands take counts too, so 
‘2)' moves forward 2 sentences; moves back three sentences. A sentence is defined as string 
of words ending with one of the characters *!’ or *?’ followed by two spaces, or occurring at 
the end of a line. 

The (beginning of next paragraph) and (beginning of previous paragraph) commands 
work similarly to the '(’ and *)* commands except they jump the cursor by paragraphs instead 
of sentences. However, if your file is text to be input to the nroff text formatter using the 
macro packages ~ms or -mm, vi recognizes the Start of paragraph* macros available in these 
packages, and positions the cursor accordingly. 

If the file you are editing contains text to be formatted using one of the nroff macro packages 
described in Printing and Formatting Documents^ you can also tell vi to move forward or back¬ 
ward whole sections by using *]]* to move forward a section, and *[[* to move back a section. 

If the text you are editing is C programming language source text, *[[* and *]]* move forward or 
backward over whole procedures. 


4.3. Scrolling the Screen 

Try the following commands to scroll the screen: 

"D scroll down half screen 
"U scroll up half screen 
*F scroll down a full screen 
scroll up a full screen 

With "F and "B, two lines from the ‘old’ screen are retained in the ‘new’ screen for continuity. 
These are the same commands you use to scroll the screen with view. 


4.3.1. Moving to Specific Lines in the File 

When editing, you may wish to position the cursor at some specific line. The command you use 
to do this is ‘G’ or ‘go to’ command. For example, to move to the beginning, type ‘IG’. To 
move to line 45, type ‘45G’. Typing the G command with no preceding line number moves the 
cursor to the last line of the file. 

To find a particular character string anywhere in the file, you use the standard ‘/’ command. It 
is echoed at the bottom line of the screen where you then type the string you want to search 
for, either as a fixed character string, or as a regular expression. Vt uses the same regular 
expressions you learned about with grep. To signal the end of the character string, type either 
ESC, or RETURN. 

Vi places the cursor at the start of the next string that matches what you typed, going forward 
through the file. 

If the string is not in the current screen, the screen is changed to display that part of the file 
which contains the string. Try this now with a string that is not on the screen, and notice how 
the screen moves to track it. 

Searches wrap around the file, so if the string isn’t found between the current position and the 
end of the file, it wraps around and continues from the beginning of the file. If the string is not 
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found, Tattem not Found^ is displayed on the bottom line of the screen. 

Use the command plus a string to search backward through the file instead of forward. 
Again, what you type is echoed on the bottom line of the screen. 

To repeat a forward search, type ‘//** To repeat a backward search, use *??*. Or use two other 
commands: 

n to find next occurrence of same string in same direction 
N to find next occurrence of same string in reverse direction 


4•4* Inserting New Text 

The two basic commands to enter new text into a file are a, which appends text after the 
current cursor position, and i which inserts text before the current cursor position. When you 
give either of these commands, any following text you type gets put in the file. To stop text 
entry, press the ESC key. 

If you are using a dumb terminal, when you type in the additional text, it might look as if you 
are over-typing the existing text. Typing ESC straightens it out. 

If you make a mistake while entering new text, correct it in the usual way with the DEL, 
BACKSPACE or keys. 

You can also use • for ‘substitute’ to enter new text; it replaces a single character with lots of 
characters, until you type ESC. 

There are two other simple commands for entering additional text: 

1 insert text at the beginning of the line 
A append text at the end of the line 

Regardless of where the cursor is positioned on a line, the I command inserts text at the begin¬ 
ning of that line; 

Similarly, A adds text at the end of the line, regardless of the cursor position. Blank lines of 
text can be inserted by using the A command and making the first character you enter a 
RETURN. 

Two other commands that can be used to add new lines of text are the ‘open lines’ commands, 
o and O. The o command opens up a blank line following the current line, and the cursor is 
placed at the beginning of the new line. Anything you type from now on, until you type ESC, 
becomes the new line or lines. To get just a blank line, type ESC immediately following the o. 

The O command works like the o command, except that it opens a line above the current one, 
instead of below. This is the easiest way to add lines before the beginning of a file. 

The uppercase R command replaces (overtypes) characters until you tell it to stop by pressing 
the ESC key. The R command is useful when you have a fixed format, for example, where you 
want to preserve column alignment. 

Lowercase r ‘replaces’ a single character. For example, if you misspelled ‘character’ as ‘cherac- 
ter,’ place the cursor on the ‘e’ typo, type the r, then type the correct ‘a’. The ‘r’ command 
does not require typing ESC, since you are replacing only one character. 
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4.5. Creating a New File 

To create a new file, simply call up ta with the name of the file you want to create: 
tutorial^ vi stuff 

The screen goes almost completely blank: 




The cursor is in the top left hand corner with a row of tildes down the left hand edge of the 
screen. The ‘~'s indicate that there are no lines in the file corresponding to these lines on the 
display. The bottom line displays the name of the file you are creating, and an indication that 
it is a new file. 


Type a or i and type in all the text you want. 

When you have finished and want to write the file away and quit the editor, type nvq. A mes¬ 
sage like: 


“stuff* 50 lines, 3172 characters 

appears at the bottom of the screen. After you have quit the editor, you see the *tutoriai%* 
hostname prompt again. 

You can now use the editor to create a .csArc file in your home directory to set the history and 
to contain aliases. 


4.6. Deleting or Changing Text 

There are several way to delete and change characters and text. 


4.6.1. Deleting Text with ‘x’ 


The simplest command to use is the ^delete character* command x. If you want to x-out five 
characters, you can do it in two different ways. You can either repeat the x five times, or you 
give the command a leading count and say 6x. 


However, if you change your mind, and want the characters replaced, the command you gave in 
the first place matters a lot. If you gave the 5x command, you can get them all back with an 
undo command of u (described later). However, if you said xxxxx, the u command only undoes 
the last X command. To restore the line to its original state, use U. 
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The difference between xxxxx and 5x is also important if you are going to use (also 
described later) to repeat changes. 

You cannot delete characters beyond the end of a line. 


4.6.2. Deleting Words and Lines with ‘dw’ and ^dd’ 

To delete a whole word^ position the cursor at the beginning of the word, and type dw. Again, 
you can give this command a count and delete more than one word at a time by typing 5dw, 
for instance. 

To delete a whole line, position the cursor anywhere on that line and type dd. The dd com¬ 
mand also takes a count, 5dd for example, to delete five lines. 

Uppercase D deletes from the cursor position to the end of a line. 

4.6.3. Changing Text 

To change just one word of text, ^dimensions' from playfile for example, put the cursor on the 
beginning of the word and type cw. You see: 

/ dimension! 

with the cursor on the first letter of ^dimensions* for example. The *$* at the end of the word 
marks which word you are changing. Then type the word you want to substitute and ESC. 
This exchanges one word for the other and adjusts the space accordingly. 


4.7. Writing Your File and Quitting the Eklitor 

Consider the following ways to save all your good work. Remember that you have to be in 
command mode to do this, otherwise you’ll find yourself entering these characters into the file. 

To save your changes, type: 

iw 

We recommend typing zw every few minutes while editing to insure that your changes are 
saved. 

If you want to save your changes and exit the editor, type any of the following: 

nvq 

or 

nc 

or 

ZZ 

Note the subtle differences here: nvq always writes out the file and then quits. The others rx 
and ZZ only write the file out if changes are made, and then quit. If no changes are made, they 
quit without writing. 

Note also that with ZZ, you do not have to type RETURN. 

If you want to exit the editor without having made any changes, type: 

sq 
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If you want to exit the editor without saving your changes/type: 

:q! 

The overrides any warning. If you are going to edit a file but might want to get back to the 
previous version, make a back-up copy of the file before running vi. 


4.8. Correcting Mistakes with ‘u’ and 

When you make mistakes while making changes or adding text, there are two *undo' commands, 
namely u and U, which make corrections easy. The lowercase u simply undoes the last change 
you made. If you have moved the cursor away from the position at which you did the change, 
the cursor is repositioned to its original place after the change has been undone. Similarly, if 
the screen has been moved since you did the change, it is moved back to its original display. 
The u command undoes any change to the edit buffer, even if that change affected many lines. 

Be careful. Giving another u command undoes the original *undo* command, thus applying the 
change all over again, but you can undo that also if necessary. 

The uppercase U command can undo several changes, but only those made on the same line. 
Once you move the cursor off the line, however, you can no longer use a U on that line. 

Beware of using u and U in succession; the one does not undo the effects of the other. 
Remember that you can also use :q!. 

4.9. Repeating a Command with 

Use * .’, the period character, called ‘dot,’ to repeat a change, either at the same position or at 
the new position. 

4.10. Running Sun Commands from Inside the Editor 

When you need to return to the Shell temporarily to process a job or get some information, you 
don’t have to leave the editor. Simply type ilcommand where command is the name of the com¬ 
mand you want. For example, to display your current directory from vi type: 

:!pwd 

/usr/evan 

Hit return to continue. 

The system displays the results of the command at the bottom of the screen, then prompts you 
with ‘Hit return to continue.’ 

You can also use the ex editor commands from vi. The ‘r’ (read) command, for example, adds 
or ‘reads’ another file into the one you are editing with vi. The ‘r’ command adds the second 
file to the first after the current line, that is, the line where the cursor is in command mode. To 
be sure you know where the current line is, type a i<CR> on the line after which you want 
the second file to be placed. This marks the current line and repositions it at the top of the 
screen. When you type the colon character, it is echoed at the bottom of the screen. What¬ 
ever you type up to RETURN is interpreted as an ex command, and also echoed at the bottom 
of the screen as you type it. 

Use the ex ‘r’ command plus the name of the file you want to read in. For instance, to read in 
the file files into the existing p/ajjf/ilc, type: 


4-8 


Revision D of 7 January 1984 




Beginner's Guide 


Creating and Editing Text Files — the vi Editor 


:r files 

This puts files after the current line, that is, the line on which the cursor was before you typed 
:r files. Be sure you know what your current line is. The bottom line of the screen displays the 
number of lines read in. This is a handy way to join files. 

To read the results of a Sun system command into the edit buffer, type: 

:r lls --1 

for instance. This reads the current directory luting into the current file. 

You now have quite a bit of information in your playfilSf so you can play around with several 
screens full to become more facile with vi. 


4.11. A Bit About the ‘ex’ Editor 

For the most part, you’ll probably use vi once you become handy with its facilities. However, 
the ex editor does have local and global text substitution capabilities that you can use from vi. 
For instance, if you decide to change the string Mollar’ in playfile to ‘greenback’, type: 

:/doilar/8/dollar/green back/ 

The first ‘dollar’ finds the string to change, and ‘s’ says to substitute for ‘dollar’ the string 
‘greenback’. This only changes the first occurrence of the string in a file. 

To change the first occurrence of the string ‘dimension’ to ‘measure’ in each line in the file, use 
the global substitution command ‘:g’: 

:g/dimension/s/dimension/measure/ 

Check through the playfile to see the result. Note that not only is the first ‘dimension’ now 
‘measure’, but the string ‘dimensionless’ is now ‘measureless’. Be careful how you specify the 
strings. This command does a global search for any string with the characters ‘dimension’ in it 
and substitutes ‘measure’ for the first occurrence in every line. 

To substitute ‘lint’ for every occurrence of ‘futt’ in every line, use: 

:g/fuss/s/fuss/lint/g 

The first ‘:g’ command searches globally, and the second ‘g’ makes the substitution called by 
‘s/fuzs/lint/’ global as well. 


4.12. Other Text Editors 

The Sun system also supports the ed and sed editors. Ed is the interactive line editor that 
forms part of the basic UNIX system. Sed is the ‘stream editor’ that is similar to ed in the 
operations it performs, but it is not interactive; it cannot move backwards in the edit file. You 
don’t use sed to make permanent changes in a file, but to ‘filter’ parts of a file as you do with 
the grepf sort, and awk utilities for example. 

Read more about these editors in Editing and Text Processing on the Sun Workstation . 
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Chapter 5 


Printing and Formatting Documents 


The most commonly used formatter on the Sun system is nroff, Nroff prepares neatly formatted 
output for a variety of printers. Nroff reads an input file containing unformatted text, inter¬ 
spersed with formatting requests and produces a neatly laid out document. The troff text for¬ 
matter is an advanced program that produces output for a phototypesetter. Troffh^A fine con¬ 
trol over sizes of characters, multiple fonts, and so on. Troff 2 knd nroff are compatible, so it*s 
possible to prepare input acceptable to both. 

Basically, nroff makes all output lines the same length, and adjusts the spacing to justify the 
left and right margins. You can also select page size, number of lines on the page, length of the 
lines, size of margins, control indentation, center headings, and underline things. With the help 
of ^macros,* either one you make yourself or a package like -m» described later in this chapter, 
you can get footnotes, automatic page numbering and titles, automatic paragraph numbering, 
and automatic generation of table of contents. This manual was formatted using -mi macros 
with troff. 

When you want to print something without any fancy formatting, headers or footers, use the 
Ipr command. You used this before in piping the sorted playfile to the line printer with: 

tutorial% sort playfile | ipr 

tutorial% 

The result is raw, unformatted text. 

The pr command ‘prepares’ a file for printing with running headers and footers, the filename, 
and the date and time the job is run. 

The fmt command is a simple text formatter that just fills lines up to about 72 columns, so your 
text then looks more like something on a standard 8-1/2 x 11 piece of paper. 

Bri^f descriptions of these follow, but if you want something fancier, use nroff and troff. 


5.1. Printing a File with ‘pr* and ‘Ipr’ 

The contents of a file can be printed using the pr and Ipr commands. The pr or ‘print file’ com¬ 
mand prints to the Standard Output, which is normally your workstation screen. An example 
of running pr on your playfile file and piping the output through more is: 
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tutorial^ pr playfile | more 
Aug 6 11:20 1983 playfile Page 1 
/ dimensions 
m *a* 
kg *b* 
sec *c* 

< etc. > 
township 36 mi2 
tun 8 barrel 

water .2249112.54 kg/m2-sec2 

< etc. > 

Aug 6 11:20 1983 playfile Page 2 

wey 40 bu 

weymass 252 Ib 

Xunit 1.00202- 13m 

k 1.38047-16 erg/degC 

tutorial% 

Pr separates the output into pages and puts a five-line header at the top and a five-line trailer 
at the foot of each page. The trailer at the foot of the page consists of blank lines. In the 
header, one of the lines forms a title consisting of a date, the filename and a page number. The 
date shown in the header is the date the file was last modified. You can change the header by 
various options to the pr command. 

What pr really does is ‘prepare’ a file for printing. Generally you use pr in conjunction with the 
Ipr ‘line printer’ command, which routes files to the printer: 

tutorial^ pr music | ipr -Pprinfcr 
tutorial% 

You can also call pr with the -p option of the Ipr command as follows: 

tutorial% Ipr -p -Ppnntcr music 
tutorial^ 

Lpr routes the named file(s), or the Standard Input if there are no named files, to the printer. It 
does nothing else, so your file is printed begirning at the very top of the page. Also, if your file 
takes more than one page, the printing carries over the perforations (assuming you are using 
continuous form paper) without a break. This is why you use lpr in conjunction with pr. 

Only error messages are displayed on the workstation screen. The exact workings of this com¬ 
mand and its options vary from one installation to another, since they largely depend on the 
number and the types of printers available. See the U$er Manual for the Sun Workstation for 
details on lpr. 

Your system has variations of the lpr command, or options to the command, which give you the 
capability of displaying the printer queue (usually the command variation Ipq) and removing 
requests from the queue (usually the command variation Iprm). 

The pr command has many options for preparing a file. See the pr details in the user’s manual. 
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6.2* Simple Text Formatting with ‘fmt’ 

Fmt is simple and fast. Try it on your playfile: 
tutorial^ fmt play file 

/ dimensions m *a* kg *b* sec ♦c* coul *d* candela *e* 
dollar *f* radian ♦g* bit *h* erlang *i* degC *j* 

< etc. > 

m2/sec2 tonne 1+ 6 gm torr mm hg township 36 mi2 tun 8 barrel 
water .2249112.54 kg/m2-sec2 wey 40 bu weymass 252 Ib Xunit 
1.00202- 13m k 1.38047-16 erg/degC 
tutorial% 

Fmt makes the lines of text reasonably even in length. 


5*3. Running ‘nrofT 

After creating your file containing text to be formatted interspersed with formatting requests, 
format the output with nroff^md pipe it through more for viewing on your workstation screen: 

tutorial^ nrofif file \ more 

Now you can proofread it. Or you can print it by piping the output to the printer. 

5,4. A Package Deal — the ‘-ms’ Macros 

The ~m» macro package provides an easier way to format documents than basic nroff if you 
want something more than straight paragraphs. It provides indented block and itemized para¬ 
graphs, page headers and footers, and page numbering. 

Some examples of calls on -ms macros are: 

.DS 
.PP 
.NH 2 

.IP ‘first stanza' 14 
.DE 

As you will see, the -ms calls look very similar to nrformatting requests. Each consists of a 
‘dot’ followed by two characters, optionally followed by arguments to the macro. All letters are 
upper case, and each macro call must be on a line of its own. 

Create a new file with the editor, perhaps using the king.art text below, and sample the -ms 
macros. Then format your file with nroff and the ms macro option: 

tutorial^ nroff -ms filename \ more 
tutorial^ 

Here you have the most useful calls for basic document formatting. For the full selection, see 
the Editing and Text Processing on the Sun Workstation. 
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5.4.I. Paragraphs — ‘.PP* and ‘*LP’ 

Mb provides two basic paragraph forms^ an indented paragraph (that is, the first line is 
indented), and a block paragraph. A standard paragraph example, unformatted and formatted 
is: 

tutoriaI% more king.art 
.PP 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow, 
tutorial^ 

And the formatted version looks like: 
tutorial^ nroff -m§ king.&rt 

King Arthur was at Caerleon upon Usk; and one day he sat in his chamber, and 
with him were Owain, the son of Urien, and Kynon, the son of Clydo, and Kay, the son 
of Kyner, and Guenever and her handmaidens at needlework by the window. In the cen¬ 
tre of the chamber King Arthur sat, upon a seat of green rushes, over which was spread 
a covering of flame-covered satin, and a cushion of red satin was under his elbow, 
tutorial^ 

For a left block paragraph, use the ‘.LP’ macro: 

tutorial/^ more king.art 
.LP 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow, 
tutorial^ 

The formatted result is: 





o 
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tutorial% nroff -ms king.art 

King Arthur was at Caerleon upon Usk; and one day he sat in his chamber, and with 
him were Owain, the son of Urien, and Kynon, the son of Clydo, and Kay, the son of 
Kyner, and Guenever and her handmaidens at needlework by the window. In the centre 
of the chamber King Arthur sat, upon a seat of green rushes, over which was spread a 
covering of flame-covered satin, and a cushion of red satin was under his elbow, 
tutorial^ 

If you don^t like these paragraph layouts, you can change them. Refer to the Editing and Text 
Processing on the Sun Workstation for details. 


5.4.2. Quoted Paragraphs — ‘.QP’ 

If you want a paragraph or paragraphs indented from the surrounding text at both the left and 
right edges, use the ‘.QP’ (quotation) macro: 

tutorial^ more mark .twain 
As Mark Twain wrote: 

•QP 

We should be careful to get out of an experience only the wisdom that is 
in it — and stop there; lest we be like the cat that sits down on a 
hot stove lid. 

She will never sit down on a hot stove like ag^in — and that is 
well; but also she will never sit down on a cold one any more. 

When formatted, this yields the following: 

tutorial^ nroff -ms mark .twain 
As Mark Twain wrote: 

We should be careful to get out of an experience only the wisdom that is in it 
— and stop there; lest we be like the cat that sits down on a hot stove lid. 

She will never sit down on a hot stove like again — and that is well; but also 

she will never sit down on a cold one any more. 

tutorial^ 

Try this now. 

5.4.3. Lists and Descriptions — MP’ 

Use the ‘.IP' macro to create the so-called ‘hanging indent’ type of paragraph, most commonly 
used for lists. You can give ‘.IP’ an argument, for instance, the number of a list item. To pro¬ 
duce a list, format your text as follows: 
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.IP 1. 

The MP' macro creates lists that you can use in many documents. 

The MP' macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

.IP 2. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

.IP 3. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The formatted version looks like: 

1. The ‘.IP’ macro creates lis^ that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

2. The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

3. The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

The ‘.IP’ macro creates lists that you can use in many documents. 

You can also make a description list, where you see the name of something on the left of the 
page, and a paragraph describing it on the right. In this case, you give ‘.IP’ two arguments, the 
first argument is the name that is to appear on the left, and the second argument is how far to 
indent the text on the right. The unformatted version looks like: 

.IP Monday 12 

Finish debugging program. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 
Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

When formatted, this looks like: 
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Monday 

Tuesday 

Wednesday 

Thursday 

Friday 


Finish debugging program. 

Meet with customers for demonstration. 
Discuss documentation plans. 

Outline training class. 

Lunch with manager. 


5.4.4. Relative Indents — and ^RE’ 

When you need to indent text in relation to previously indented text, use the ‘.RS’ and *.RE’ 
(relative indent start and end) macros. For example: 

.IP 1. 

pigs cows chickens ducks 

.RS 

.IP * 3 

pigs cows chickens ducks 
.IP * 3 

pigs cows chickens ducks 

.RE 

.IP 2. 

pigs cows chickens ducks 

.RS 

.IP ♦ 3 

pigs cows chickens ducks 
.IP *3 

pigs cows chickens ducks 
.RE 

when formatted looks like: 

1. pigs cows chickens ducks 

♦ pigs cows chickens ducks 

♦ pigs cows chickens ducks 

2. pigs cows chickens ducks 

* pigs cows chickens ducks 

* pigs cows chickens ducks 
This is particularly useful for outlines. 

5.4.5. Section and Paragraph Headings 

You can have numbered headings up to five levels and un-numbered headings. All headings are 
underlined by default (headings are made boldface if you are using Iroj0), and may occupy 
several lines if required. 
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5.4.5.I. Un-numbered Headings — ‘.SH’ 

Use the SSH' (section heading) macro to introduce an un-number^ heading. For instance, the 
output; 

text and more text at the end of a paragraph. 

A Section Heading 

A new paragraph of text and more text 
that continues and continues and continues. 

was generated by using the formatting macros: 

text and more text at the end of a paragraph. 

.SH 

A Section Heading 
.PP 

A new paragraph of text and more text 
that continues and continues and continues. 

Put the macro on one line and the actual heading on the following line or lines of the input 
text. Begin the first paragraph following the heading with a ‘.LP’ or *.PP* macro to signal the 
end of the heading. 


5.4.5.2. Numbered Headings — ‘.NH’ 

To introduce a numbered heading, use ‘.NH*. ‘.NH’ implies a level 1 heading, and ‘.NH n’ 
where *n’ is a number calls the corresponding level number. For instance, consider the format¬ 
ting of this chapter in outline form: 

.NH 

Printing and Formatting Documents 

.LP 

.NH 2 

Printing a File with ‘pr’ and ‘Ipr’ 

.LP 
.NH 2 

Simple Text Formatting with *fmt* 

.LP 
.NH 2 

^ Running ‘nroff’ 

.LP 
.NH 2 

A Package Deal — the ‘-ms’ Macros 

.LP 

.NH3 

Paragraphs — ‘.PP’ and ‘.LP’ 

.LP 

When formatted, it looks like: 
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5. Printing and Formatting Documents 

5.1 Printing a File with *pr* and ‘Ipr* 

5.2 Simple Text Formatting with *fmt’ 

5.3 Running *nroff* 

5.4 A Package Deal — the ‘-ms* Macros 
5.4.1 Paragraphs — ‘.FP* and ‘XP* 


5.4.6. The Date — ‘.ND* and ‘.DA* 

To avoid having the current date at the bottom of every page of your document, put the macro 
call ‘.ND’ at the beginning of your input text. 

To change the date shown on the bottom of every page, put the ‘.DA^ macro at the beginning of 
your input text: 

.DA 8 June 1982 

This also allows you to specify the exact format of date that you want, for example: 

.DA 1982-5-8 


5.4.7. Displays — ‘.DS’ and ‘.DE’ 

A ‘display’ is some text that you want to appear as you typed it without any filling of lines, 
indented from the surrounding text, and kept together on the same page. Use the two macros 
‘.DS’ (display start) and ‘.DE’ (display end); the text that appears between these forms the 
display. Consider the following formatted text: 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow, 
which was formatted by: 
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.DS 

King Arthur was at Caerleon upon Usk; 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

.DE 

You can further format your displays with the macros ‘.DS B', which justifies the left margin, 
then centers the whole display, ‘.DS h\ which displays the text as is without indenting, and 
*.DS C’, which centers each line of text individually on the page. 

We used the ‘.DS^ and ‘.DE’ macros throughout this manual to o&et the screen displays. 


5.4.8. Keeping Text Together — ‘.KS’ *.KF* and ‘.KE* 

To keep lines of text together on one page, for a quotation, for example, use ‘.KS’ to mark the 
start of the text to be kept together (keep start), and ‘.KE’ (keep end) to mark the end of the 
text to be kept together. This is particularly useful for keeping the text of a table or list 
together for example. If there is not sufllcient room on the current page for the formatted ver¬ 
sion of the text between these two macro calls, -ms starts a new page, leaving the remainder of 
the current page blank. An example looks like: 

.KS 

.IP Monday 12 

Finish debugging the compiler. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 
Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

.KE 

If you are working with text that must be kept together, but that need not immediately follow 
the reference to it, use the floating keep ‘.KF’ and ‘.KE’ macro pair. The text is kept together, 
and the remainder of the current page is filled with the following text. 
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.KF 

.IP Monday 12 

Finish debugging the compiler. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 

Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

.KE 


5.4.9• Titles and Cover Sheets 

If you want to include a title and an author, or maybe even several authors on your document, 
use the *.TL’ macro to specify the title of the document and the ‘.AU’ macro to show the 
author or authors. Only the ^DA* or ^ND' macro calls to change or suppress the date may 
appear before these macros. 

Here is an example of calling the macros: 

.TL 

Beginner’s Guide 
.AU 

Sonny Systems 
.NH 

GETTING STARTED 
.LP 

Sit down at your Sun Workstation. 

The first page of formatted text produced looks like: 

Beginner’s Guide 

Sonny Systems 

1. GETTING STARTED 

Sit down at your Sun Workstation. 


5.4.10. Overall Page Layout 

By default, -ms provides page numbers in the center at the top of each page of the form ^-2-’. 
The run date appears at the bottom of each page when run with nroff. The top and bottom 
page margins are set to one inch. The line length is set to six inches, and there is no page 
offset. Many of these default parameters can be changed. See Formatting Document with the 
-ms Macro Package m the Editing and Text Processing manual. 
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5,6. Laying Out Tables with ‘tbl* 

Assume you have material that you want to lay out in tabular format, in rows and columns of 
text with captions, headers, and such. Numeric material requires column alignment different 
from alphabetic material. For this, use the tbl utility, which is a pre-processor for troff and for 
nroff. In general, the tbl capabilities can only be fully exploited when used in conjunction with 
trofff but some of the simpler aspects work with nr off. 

Use the ^TS’ and ^TE’ macros just as you do any other set of begin and end macros to bracket 
the desired text: 

.TS 

Description of the Table Layout 

Data to be Laid Out 

.TE 

Leaving out one or the other of this set can have all sorts of weird results on your output. 

The tbl processor sees a table in terms of three distinct parts: 

1. The overall layout or form of the table. For instance, whether the table is centered on 
the page, or whether the table is to be enclosed in a box. 

2. The layout of each line of data in the table. This part determines how each column in 
the table is laid out. For instance, whether it is left-adjusted, or centered, or whether 
numeric data must be aligned on the decimal point. 

3. The actual data (the textual material) of the table itself. 

Study the following simple example: 

.TS 

tab(/); 

111 . 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/l833/4 
Gustav Mahler/1860/9 
.TE 

The line with tab (j) ; on it is the so called ^options’ part of the table. This is the first part in 
the list above. In this particular case, the only option to tbl is to tell it that the ‘tab* character 
is to be a slash character. Normally, tbl expects to see the columns of data in the data part of a 
table separated by real tab ("I) characters. Our example uses a visible character that is not 
part of the data, the slash character /, in this case because it’s easier to see what’s going on. 
Terminate the options part of the table by a semicolon. 

The next part of the table header is the description of how the actual columns of data are to be 
laid out, part 2 from the list above. In this case, there are three left-adjusted columns, indi¬ 
cated by the I format letters. You can have many lines of format descriptions. Each line of for¬ 
mat description in part 2 of the table corresponds to a single data line in part 3, the data part 
of the table. If, however, there are more lines of data in the data part of the table than there 
are format description lines, the last line of the format description part applies to all the 
remaining lines of the data. Here, the three letter I format letters apply to every line in the 
data part of the table. Terminate the format descriptions with a period at the end of the last 
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one. 

Then add the actual data of the table, each field of which is separated from the next by the / 
character. Here you learn the birthdates and number of symphonies composed by several well- 
known classical composers. 

Now create a file called music with this text, format the table and display it for viewing by typ¬ 
ing: 


tutorial^ tbl music | nroff 

-ms 1 

more 

Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


You can of course also redirect the output to a file with or give tbi a list of files, which are 
processed one by one in the order in which you specified them on the command line. Here the 
table appears on the left hand side of the page. You probably would prefer it centered in run¬ 
ning text, in which case you add a center option to the options part of the text: 

.TS 

center tab (/) ; 

111 . 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/18^/4 
Gustav Mahler/1860/9 
.TE 

When formatted, this looks like: 

tutorial% tbl music | nrofif -ms | more 


Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


To align numerical entries, you must treat numbers as numbers, not just as any character. 
Change the format specification letters for the birthdate and number of symphonies: 
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.TS 

center tab (/); 

Inn. 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoyen/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahlcr/1860/9 
.TE 

The format specification part indicates that the second and third columns are numerically (*n*) 
aligned columns so the data in the second and third columns of each line is aligned properly to 
the right. The formatted version looks like: 

tutorial^ tbl music | nroff —ms | more 


Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


To add captions for the individual columns^ see what has been included in the following: 

.TS 

center tab (/); 
c c c 
Inn. 

Composer/Birthdate/No. of Symphonies 
.sp 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

The example above now shows an extra line in the format description part, and some extra 
data in the data part. The first line of the format descriptions indicates that there are to be 
three columns of data, each one centered within its column. This format applies to the very 
first line of the data. The second (and last) line of the format description part is the same as 
before, and it applies to all the remaining data lines in the table. 

This new layout looks like: 
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tutorial^ tbl music | nroff —ms | more 


Composer 

Birthdate 

No. of Symphonies 

Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


By the way, when you describe a table, the format description part, part 2 of the table, must 
always describe the largest number of columns which that table has. If there are some lines 
which have fewer columns of data, you must indicate what to do with those specific lines. 

You can also print a table with a centered overall heading line for the entire table. This is 
called a ‘spanned heading,* meaning that that a column of data spans across into the next 
column. 

.TS 

center tab (/); 
css 
c c c 
Inn. 

Music Trivia 
.sp 

Composer/Birthdate/No. of Symphonies 
.sp 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

Here the result is: 

tutorial^ tbl music | nroff -ms | more 

Music Trivia 


Composer 

Birthdate 

No. of Symphonies 

Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


The first line of the format description part now shows a centered, spanned column. A spanned 
element can span as many or as few columns as you like. 
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Read the Editing and Text Processing on the Sun Workstatin for the details of tbTs other capar 
bilities. 

5.6. Formatting Mathematical Equations with *eqn’ 

The eqn and neqn packages aid preparation of documents containing mathematical equations. 
Eqn is a preprocessor for troff^ and ncijn is a preprocessor for nroff. The preprocessors set the 
mathematics while troff and nroff do the text of a document. These turn English-like descrip¬ 
tions of an equation into the formatting request for generating the mathematical symbols for 
that equation. The capabilities are restricted by the limitations of typewriter-like printers. 
Enclose equations with ^EQ' and *.EN* to tell eqn where the equations begin and end. A simple 
example is: 

.EQ 

x=y+ z 
.EN 

which produces: 

x=y+z 

You can print mathematical symbols and names and the Greek alphabet with eqr^ 

.EQ 

X—2 pi int sin ( omega t)dt 
.EN 

which produces: 

x—2irjBm{Qjt)dt 

(Note that your printer may not handle these fancy fonts.) You can also produce superscripts 
and subscripts for example with the words sup and sub: 

.EQ 

y — c sub 1 x sup 2 + c sub 2 x -f* c sub 3 
.EN 

which produces: 

Eqn does not process ‘.EQ’ and ‘.EN’ other than to take care of the equation between them. So 
you have to center, number, and justify the equations yourself or use eqn in conjunction with 
the -ms macro package, which as you know, takes care of those things for you. Sec Editing and 
Text Processing tor details. 

5.7. Formatting with ‘nrofF or ‘trofP 

Prepare the input file, using an editor, and embed the nroff or requests in the text of the 
document to be formatted. Put each request itself at the beginning of a line. A request cannot 
appear on the same line as the text to be formatted, although sometimes part of the text to be 
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formatted can be given as an argument to a request. A formatting request consists of a basic 
nroff instruction, (a period or ‘dot* followed by one or two characters), or a call to an nroff 
macro, optionally followed by one or more arguments separated by spaces. 

Some examples look like: 


.sp 
.po 8 
.bp 
.in 5 
.ti -3 
.in + 5 
.ce 4 
’ul 


Putting a space between the instruction and any numerical value that an argument may take 
makes the requests easier to read, although it*s not necessary. 

An argument may also be a number preceded by a plus sign or a minus sign. This means a 
change relative to the existing value of whatever it is youVe altering. For example, ‘.in + 5* 
means indent the margin 5 spaces more than what it is now, and similarly ‘.in -4* means back 
off that indent by 4 spaces. 


5.7.1. Page Breaks — ‘.bp’ 

To do your own page breaks, insert the ‘.bp’ (break page) at strategic points in your document. 
The macro package automatically does this, but sometimes you may want to force a new page. 


5.7.2. Blank Lines — ‘.sp’ 

You can put blank lines in the output by using the ‘.sp’ request. The appropriate number of 
blank lines are left in the output text. For example, to put three blank lines between sentences, 
use ‘.sp 3’: 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

.sp 3 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow, 
which when formatted is: 
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King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clyde, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 


In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

An \sp’ request with no argument leaves one blank line in the output. Or you can produce a 
blank line by just leaving blank lines in the input text. Using ^sp* is better because it is easier 
to change later if you decide to add more or fewer blank lines. 

5.7.3. Centering and Underlining — ‘xe’ and ‘.ul* 

Use the ‘.ce’ request to center lines of text. The ‘.ce’ request without an argument centers one 
line, for example: 


.ce 

Beginner's Guide 
centers the following line of text: 

Beginner's Guide 

To center more than one line of text, type: 

.ce 3 

ducks chickens 
cows ducks chickens 
pigs cows ducks chickens 

centers the following three lines of text: 

ducks chickens 
cows ducks chickens 
pigs cows ducks chickens 

Filling is temporarily turned off when lines are centered, so each line in the input appears as a 
line in the output, centered between the left and right margins. 

If you don't want to count how many lines you want centered, say: 

.ce 100 

Some random number of text lines 
< etc. > 

.ce 0 

The ‘.ce 0’ request simply stops the centering process. 
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Note that the argument to the ^ce^ request only applies to following text lines in the input, 
request lines are not counted. 

Underlining is somewhat misleading, for nroff underlines and troff itaiicizes the words. If you 
want to ‘underline’ a heading for example, and format the text with nroffy use the ‘.uP nrojf 
request, and type: 

.ul 

ducks 

which underlines as: 

dqd^ 

You can use the same numbering count with ‘.ul’ as with ‘.ce’. 

You can of course also this to emphasize single words: 

The best way to learn a new system is 
not just to read about it, but to 
.ul 
use 

the facilities it provides. 

Troff produces: ‘The best way to learn a new system is not just to read about it, but to use the 
facilities it provides.’ Notice that you have to arrange your input so that the word you want 
underlined appears on a line of its own. 

5.7.4. Indentation — Mn’ 

To indent lines of text, use the ‘.in’ request. For example, ‘.in 5’ indents all following lines five 
spaces. 

.in 5 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clyde, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

.in 0 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

Use ‘.in 0’ to turn off the indent. 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 

upon a seat of green rushes, 

over which was spread a covering of 
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flame-covered satin, 

and a cushion of red satin was under his elbow. 


5*7.5. Temporary Indents — ‘.ti* 

For a temporary indent in relation to the current, use the ‘.ti* (temporary indent) request. This 
works on the following line only. For example: 

.ti 5 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

produces: 

King Arthur was at Caerleon upon Usk; 
and one day he sat in his chamber, 
and with him were Owain, the son of Urien, 
and Kynon, the son of Clydo, and Kay, the son of Kyner, 
and Guenever and her handmaidens at needlework by the window. 

5.7,6. Filling — ‘.nF and ‘.fi’ 

If you don^t want lines filled in, use the ‘.nf (no fill) request. Lines arc still left justified. To 
turn filling back on after youVe entered text, type the *.fi* (filling) request. The formatted ver¬ 
sion follows the unformatted version here. 

King Arthur was at Caerleon upon Usk; 
and one day he sat in his chamber, 
and with him were 
.nf 

Owain, the son of Urien, 
and Kynon, the son of Clydo, 
and Kay, the son of Kyner, 
and Guenever 

and her handmaidens at needlework by the window. 

.fi 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 
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King Arthur was at Caerleon upon Usk; and one day he sat in his chamber, and with 
him were 

Owain, the son of Uricn, 
and Kynon, the son of Clyde, 
and Kay, the son of Kyner, 
and Guenever 

and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, upon a scat of green rushes, over which 
was spread a covering of flame-covered satin, and a cushion of red satin was under his 
elbow. 
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Chapter 6 

Communications 


The Sun system provides several facilities for communicating with local and remote hosts. You 
can use mail to send messages, which your friends can read at their leisure, save and respond to 
as necessary. For a quick message, there's the write command that sends the message to 
another user immediately. The network news provides a widely distributed network for com¬ 
municating news items. The tip utility provides dial-up phone access to other systems. For 
more information on mail and the network news, refer to the Mail U$er*$ Guide and the Net- 
work News User > Guide in Part Two of this manual. For information on write and tipj see the 
User^s Manual for the Sun Workstation, 

For set-up instructions on either of these two facilities, refer to the System Manager *s Manual 
for the Sun Workstation . 



6.1. The Electronic System 

When you send mail to another user, the messages pile up in a ^mailbox.' If your recipient is 
logged in and has set mail set in his .login file, he is notified that mail has arrived when he com¬ 
pletes whatever command he is using at the time. If he is not logged in, your message is saved 
in the mailbox file, and the recipient is notified that he has mail the next time he logs in. 

The mail program keeps track of what you do with your mail; it records whether you throw a 
message away, save it in your mailbox, write it to a separate file, or respond to it, for example. 

When you log in, or sometime during a work session, you will receive the message: 

You have mail. 


or 

You have new mail. 

indicating that you have mail in your ‘mailbox.’ 


6.I.I. Reading Your Mail 

To read your mail, type: 


o 
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tutorial^ mall 

Mail version 2*17 12/20/82. Type f for help. 

*‘/usr/spool/m3il/evaB^^: 1 message 1 unread 
1 lori@tutorial Tue Oct 29 12:43 

& 

The system responds with a numbered list of messages. To read your mail, type either 
RETURN for the next message or: 

& p 

From lori Fri May 4 21:20:03 1983 
Date: 4 May 83 21:19:54 PDT (Fri) 

From: lori (Lori Rosen) 

Message-Id: <8307020419.AAOl512@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA01512; 4 May 83 21:19:54 PDT (Fri) 

To: evan 
Status: R 

Are you going to the birthday party this evening? 

I need a ride. 

& 

for the current message, or pn where the number n is for the message of that number. The 
example above is an approximate representation as the message heading varies with who sent 
you the mail, from what system, and so on. 

To save the message in a file for future reference, type: 

& 8 filename 

where filename is your chosen filename. Note that this appends the message to the named file 
and does not overwrite any existing contents. 

To quit the mail program and have your mail correspondence updated automatically on what 
messages you have and have not read, type: 

& q 

To delete the message you just read, type: 

& d 

To delete a specific message, number 5 for instance, type: 

& d5 

Your mail is erased, unless you ‘undelete^ a specified message with the u command before you 
leave mail 

And if you want to leave mail and get back to the Shell without making any changes to your 
messages or reading any of your mail, type: 

fe X 

for ‘exit.^ Any deleted messages are undeleted. 

You can get help at any time during this correspondence by typing a *?’ sign, and mail displays 
a quick and dirty summary of the most helpful responses. 
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Table 5-1: Mail Quick Summary 


&T 

c <directory> 
d < message list> 
e <message list> 
f < message list> 
h 

m <user list> 
n 

p < message l!st> 
prc < message list> 

q 

r < message list> 

R < message list> 
s <messagel list> file 
t < message list> 
top < message list> 
n < message list> 
w <message list> file 


cbdir to directory or home if none given 
delete messages 
edit messages 

show from lines of messages 
print out active message headers 
mail to specific users 
goto and type next message 
print messages 

make message go back to system mailbox 
quit, saving unresolved messages in mbox 
reply to sender only of messages 
reply to messages 
append messages to file 
type messages (same as print) 
show top lines of messages 
undelete messages 

append messages to file, without from line 
quit, do not change system mailbox 
shell escape 


A < message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted. Mail uses the last message typed. 


6.1.2. Replying to Mail 

There are two ways to reply to mail. You can type an V, which sends a response only to the 
sender of the message and not to any of the names listed as Cc:^s (more on this later). 

Or, you can type a *R* to respond to everyone who received the original message. To reply to 
the sender only, type; 

& reply 

at the mail prompt or just ‘r’ for short. 

& r 

To: lori 

You see the message header To: lori' for example, and you can type in your response, ter¬ 
minated by a "D. 

6.1.2.1* Your Own Mailbox or ^inbox’ 

To save the mail in your mbox (mailbox) file, type: 

& q 

for ‘quit' when you arc done reading your mail. This appends any messages you have read, but 
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not deleted during the current session to the mbox file in your home directory or creates the file 
the first time you use ‘quit’. 


6.1.3. Sending Mail 

Assuming that you are using the Sun system network, and that you are sending mail to one of 
your colleagues on another host system, use the mail command and indicate the recipient and 
his hostname. For instance, to send mail to ‘kathy’ whose hostname is Venus,’ type: 

tutorial^ mail kathyQvenus 

We are moving the project due date up one week. 

Let me know if this causes a problem. 

EOT 

tutorial^ 

Ask your system administrator for the names of other users’ hosts. 

To send mail to someone with an account on the same system b even easier. Assuming you are 
logged in to ‘angel’ and want to send mail to Steve, who also has an account on ‘angel’, simply 
type: 

angel% mail steve 

Will you be out of town on business next week? 

angel% 

Try sending mail to yourself. Be patient; mail delivery is not instantaneous, and it often takes 
a few seconds for you to be notified that ‘You have new mail.’ {Mail b handled by a background 
process.) 

6.1.4. Personalizing Your Mail in Your .mailrc File 

Just as you have a .login and a .cthre file in which you can customize your account, you can 
also create a .mailrc file in your home directory to prompt you for additional information in 
messages and to provide the same kind of alia$ shorthand as in your .csArc file. 

If you would like to be prompted for a ‘Subject:’ header, include the ‘ask’ option in your .mailrc 
file: 

set ask 

Now try sending yourself mail as follows: 

tutorial^ mail lori 
Subject: Sending Mail 

Thb shows how to get a ‘Subject:’ header 
when sending mail. 

"D 

tutorial^ 

If you want to send copies of a letter to a dbtribution list, edit your .mailrc file to include: 
set askee 

which will then prompt you with ‘Cc:’ when you terminate a message with *D. Again, try It on 
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yourself: 

tutoriai% mall lori 
Subject: Sending Copies 
This shows how to send copies 
of messages. 

‘D 

Cc: Chris 
tutorial^ 


6.I.4.I. Distribution Lists and Aliases 

As you learned in the chapter on lining the Shellf you can set aliases for long lists of commands 
or names. This is particularly useful here for distributing copies of letters to the various 
members of a project group for instance. 

Put an ^alias^ in your .mailrc file, for example: 

alias gang jon tom marty steve evanOvenus 

which specifies the members of a particular project. 

tutorial^ mail gang 
Subject: Priorities 

It is critical to get the product completed by November. 

tutorial^ 

Remember that all these message recipient names are really login names, but the alias may 
include ‘evanOvenus’ for mailing to remote hosts. 

6.2. Writing to Other Users with ‘write’ 

The write command immediately sends a message to a specified user, when you type the mes> 
sage, provided that the recipient is logged in to the same system at the time. Use write only 
when it’s a real emergency because it does bother some people when messages start appearing 
while they’re trying to type at the workstation. 

If your recipient is logged in over a phone line, their phone will be continuously busy, so write is 
the easiest way to reach them. 

A typical example of how to use write is: 

tutorial^ write joann 

Is the customer demo ready? 

"D 

tutorial^ 

You are not prompted after you type write and the login name, so simply type in the message 
you want to send, as many lines as you like, and end it with the end-of-text character, "D. You 
don’t get any indication that your message has actually been received. 

What the recipient, ’’joann”, sees is: 
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Message from tutorialllori on ttyOS at 10:42 ... 

Is the customer demo ready? 

EOF 

^tutoriaF is the hostname of the system that Joann and Brad are using. The EOF indicates 
that the message is finished, and Brad has quit writing. 

This is a simple one-line message, but if you send more than one line, your recipient doesn^t get 
it all at once. He sees each line only after a RETURN is typed, so the EOF is the only indica¬ 
tion that the message is complete. This causes problems for a two-way conversation, which is 
usually what youMl use. For example, suppose Brad tries to get in touch with Jay: 

tutorial^ write jay 

but doesn^t immediately enter the message to see if Jay b logged on. Jay receives a message 
that says: 

Message from tutoriallbrad on ttyOS at 10:45 ... 

At this point Jay gives his own write command: 

t!tan% write brad 
Hi. What? 

Jay doesn^t type "D, so now Jay and Brad are 'talking* to each other, until one of them types 
"D to drop out of the conversation. 

At the end of the conversation, Brad*s screen might look like this: 
tutorial% write jay 

Message from tutorialljay on tty04 at 10:45 ... 

Hi. What? 

How about dbcussing the project thb afternoon? 

There’s a department meeting. Sorry. 

Maybe tomorrow 
morning? 

Sounds good. 

tutorial^ 

What Brad has typed is shown boldface, Jay’s replies are in normal type. Jay’s screen looks 
like: 

tutorial^ Message from tutoriallbrad ttyOS at 10:45 ... 
write brad 
Hi. What? 

How about discussing the project this afternoon? 

There’s a department meeting. Sorry. 

Maybe tomorrow 
morning? 

Sounds good. 

EOF 

"D 

tutorial% 

Here we have shown what Jay typed boldface, and Brad’s contributions in normal type. Here 
the dialogue consisted of simple one-line questions, but if you arc going to provide several lines 
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of information rather than ask questions, use the protocol, which suggests that you terminate 
each message with the character o, for *oTer*, and when you are about to quit the conversation, 
type oo, for *over and out\ You can also set up your personal protocol with your colleagues. 

If you try to write to someone who b not logged in, you get a message: 

tutorial% write sylvIa 
Sylvia not logged in. 
tutorial^ 

and write terminates. You get the same response if you try to write to someone who is not a 
user, because write doesn’t check for known system users, only for users logged in. Remember 
that you can always use the who command to see who is logged in: 

tutorial^ who 
susan tty00 08:30 
henry tty03 08:31 
jay tty04 09:05 
susan ttyOO 09:15 
hank tty07 09:15 
brad tty08 09:10 
tutorial% 

If you have already started typing your message when the system finds that the user is not 
logged in, and decides to ignore your command, cancel what you have typed using your line kill 
character (*U). This is not critical, but it can be disconcerting when the system tries to inter- 
pret your partial message as a command next time you press RETURN. 

You may try to write to someone and get the response: 

tutorial% write hank 
Permission denied, 
tutorial^ 

This means that the recipient is using one of the system commands that iocks out’ the write 
command to prevent messages from messing up nicely formatted output. This is the same mes¬ 
sage you get if you try to write to a user who has used meeg to prevent you writing to his 
workstation. Mesg is described later. 

What’s really happening here is that you are writing to the user’s workstation or terminal, for 
example, to ttyOS, where our who example shows Brad is logged in. 

The example of the who command shows that the user *susan’ is logged in to the system twice, 
once on ttyOO, and again on ttyOO. Choose one, and if you don’t get a response, quit that write 
and try to get the user on the other: 
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ttttoria]% write eusan ity05 
Are you there? 

•D 

tutorial^ write susan ttyOO 
Are you there? 

Message from tntorialfsusan ttyOO... 

Yes. What’s up? 

Working late? 

Yes. See you tomorrow. 

EOF 

tutorial^ 

If you don’t specify a terminal, write chooses one for you: 

tutorial^ write susan 
susan logged more than once 
writing to ttyOO 

Write chooses the lowest number terminal, so if you don’t get a response there, specify the par¬ 
ticular tty number to get messages sent to the other terminal. 

If you have a long message to communicate, use a text editor to prepare the message in a file 
and correct any mistakes before anyone else sees them. Send this message by redirecting the 
Standard Input: 

tutorial^ write jay < message 
tutorial^ 

The recipient receives the message all at once. There is no waiting between lines, as there is 
when the message is typed following the write command. Use the mail command described 
above to send veiy long messages so your recipient can choose his own time to read them. 

Here as in the editor, you can use the exclamation mark character ! to call a system command. 
For instance, suppose you want to find the location of some files and let someone else know. 
You change to the desired directory and start writing. If you forget the name of the directory, 
you can find out in the middle of writing by saying: 

tutorial% write joe 

The files you want are in the directory: 

!pwd 

/dd/projec t/br ad / docs/memos 
t 

/dd/project/brad/docs/memos 

D 

tutorial^ 

You still have to type in the output of the command called by *!*. Of course, the command you 
give following M’ may have nothing to do with the message you are sending. You may also 
redirect the Standard Output of the command, so you don’t see any output on the screen. The 
second '!’ signals command termination. 
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0.3. Preventing Message Interruptions with ‘mesg’ 

If you dislike being interrupted by your friends* messages while you are programming at your 
workstation and especially when you are using a text editor, set the metg command to *n’ to 
stop incoming messages: 

tutorial^ mesg n 
tutorial% 

This ‘no* tells the system to prevent someone else from writing to you. The message sender 
sees: 

Permission denied. 

The default is *yes*, and you can check how yours is set by typing: 

tutorial^ mesg 
isy 

tutorial^ 

As a first-time user, yours is undoubtedly still enabled. Setting metg to ‘no* only lasts for your 
current login session unless you set it permanently. To do this, edit your your .login file to 
include: 

mesg n 


6.4. Local Area Network Facilities 

Your local network lets you log in to other systems or ‘rhosts* (remote hosts) to do work, copy 
files, or whatever. 

6.4.I. Making Connections with ^rlogin* and ^rsh’ 

Use the rlogtn (remote login) command to log in to another system. For example, to do a 
remote login to the ‘angel* system from your host ‘tutorial,* use the rhgin command: 

tutorial% rlogin angel 

Last login: Mon Jul 11 22:23:40 am ttypO 

Sun UNIX 4.2 (Berkeley beta release) (GENERIC) #8: Wed Oct 23 13:45:52 PDT 1983 
angel% 

You can then login as you normally do, although a password is not necessary if you log in as the 
same user on an equivalent host. In both cases, your local user name must exist on the remote 
host to allow remote command execution as there isn*t any password prompt. Your system 
administrator sets this up for you. 

You can write to another user on the system or send mail without having to provide a hostname 
if you*re on the same system. 

Log out as you normally do: 

angel% logout 
Connection closed, 
tutorial^ 

You can go on with your local work as before. 
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If you want to execute a single command on another system, use the rsk (remote Shell) com¬ 
mand. For instance, to find out who is logged in on ‘angel*, say: 

tutorial^ rah angel who 
lori console Jul 28 09:48 
tutorial^ 


6.4.2. Copying Files From Other Systems with ‘rep’ 

Your local network also allows you to copy files from one ^tem to another with the rep 
(remote copy) command. For example, if you need one of your colleague*8 files from another 
system, type: 

tutorial^ rep kryptoni/uar/henry/mise/plao • 

tutorial^ 

This copies from f utrJhenry!mi$c system ‘krypton’ the plan file into your current (or dot ‘.’) 
directory on your host ‘tutorial’. If you need to copy a directoiy with its contents, use the ~r 
(recursive) option: 

tutorial^ rep -r krypiont/uar/henry/mbe • 

tutorial % 

This copies all of the mise directory, including any subdirectories and files, into your current 
directory. 

Note that if you’re using ‘| ]’, *$*, *<’, *>’, “’or as with rsh, you must enclose the 

path in quotes. For example: 

tutorial^ rep ~r ’venu8!/u8r/kathy/miac/chap** • 

tutorial^ 

This quotation prevents some strange and undesirable filename expansion. 


6.5. Additional Communication Facilities 

The Sun system supports several addition?! communication facilites for which detailed descrip¬ 
tions are out of the scope of this manual. We introduce these facilities to you here and recom¬ 
mend that you read the indicated documentation and user’s manual pages for instructions on 
how to use them if you are interested. 

The UUCP (UNIX-to-UNIX copy) utility provides networking of machines over phone lines. The 
mat/ facility uses it to send mail to users at remote sites and the network news facility described 
below uses it to transmit news articles. The tip facility permits file transfers between machines. 

6.5.1. Network News 

The network news, or simply ne/new»f provides access to the USENET (User’s Network). Net- 
news is a communication facility for sharing information among a large number of users. It can 
be described as an electronic bulletin board. You can send articles from one machine to another 
for limited or very wide distribution, post an article to interested persons, browse through old 
news, post follow-up articles, and send direct electronic mail replies to the author of an article. 
You can select the articles, which are arranged in categories called newsgroups. 


6-10 


Revision D of 7 January 1984 




Beginner s Guide 


Communications 




See the Network Newt liter Guide in Part Two of this manual for details. 

6.5*2. Dialing to Remote Systems with ^tip’ 

With the tip utility, you can dial in with a phone hook-up to a remote system to transfer files 
from one machine to another. You must have a login name on the remote machine. You can 
use either the name of the remote system or the phone number with the lip command to make 
the connection. 

A typical example b: 

tutorial% tip tymnet 
dialing ... connected 

Or you can use the phone number of the desired system by typing: 

tutorial^ tip XXX XXXXXXX 
dialing ••• connected 

where XXX XXXXXXX is the phone number. Ask your system administrator for specific 
details. 

Occasionally, you may receive the response: 

dialing ... no answer 
EOT 


or 

all ports busy 

which can mean a number of things, such as all outgoing lines are busy. 
A tilde (~) at the beginning of a line is the escape character. 

To logout, type “.. 

For a full description of tip, refer to the user's manual. 
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This summary provides brief descriptions of the Sun system facilities. 

General Characteristics 
Device-independent IJO and redirection 

Highly efficient buffered stream I/O is integrated with formatted input and output. 

Virtual memory 

Supports processes up to 16 megabytes (given adequate disk space for paging) for greatly 
enhanced amount of available main memory and reduced delays when running programs as 
only the parts of the program needed to be loaded in core are in fact loaded. 

Hierarchical File System 

The file system uses large blocks on the disk and incorporates knowledge of disk geometry 
to maximize throughput and minimize seek time. 

Job Control Facilities 

Support for multiplexing of terminals between jobs; running several jobs at once, some in 
the background and others in the foreground and moving running jobs from background to 
foreground and vice-versa. 

Interprocess Communication 

Network communication using standard protocols. Inter-process communications integrated 
into UNIX. User access to interprocess and network communication through sockets. Arbi¬ 
trary processes in the system may communicate in either a message or stream oriented 
fashion. Provide remote logins, copies, and Shells over the local network. 

Diskless Operation 

The diskless workstation allows larger and more cost effective drives to be used by centraliz¬ 
ing disk storage. In a clustered configuration, file-sharing is promoted by the existence of 
file servers, which support all disk and paging traffic. Access protocol protects clients of the 
server against server crashes, a server crash resulting only in interrupted service. 

Networking 

The 4.2 system includes an ISO-OSI model local networking subsystem. Fully supported is 
the DARPA internet family of protocols and associated addressing. The datagram (UDP) 
and stream (TCP) protocols arc supported, as well as the error message protocol (ICMP) 
and packet forwarding at the internet layer (IP). A routing information protocol allows 
hosts to determine the shortest route to a destination within the local network. 
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C’Shell 

A powerful interactive command interpreter, which provides foreground-background type 
job control, a history mechanism to greatly reduce the amount of typing at the command 
level, and a macro-like aliasing facility for personalizing the command environment. It sup¬ 
ports string variables, trap handling, structured programming, user profiles, settable search 
paths, and multilevel filename generation. 

Mail 

User-friendly interactive mail facility that makes it easy to deal with large volumes of mail. 
SunCore 

An implementation of the ACM Siggraph standard package of graphics software, plus 
extensions. SunCore is implemented to level 3C of the ACM Core specification for output 
primitives and to level 2 of the ACM Core specification for input primitives. Extensions to 
the Core include textured polygon fill algorithms, including 2D and 3D operations, raster 
primitives, rasterop attributes, shaded surface polygon rendering and hidden surface elimi¬ 
nation. 

Sun Windows 

The SunWindows system emphasizes extensibility, accessibility at multiple layers, and pro¬ 
vision of appropriate parts and development tools. Specific applications are provided as 
examples, and the system is designed to be expanded by clients. There is open access to 
lower levels, and convenient and powerful facilities for common requirements at higher lev¬ 
els. Standard tool windows are available, such as shell tools and graphics tools. These win¬ 
dows may overlap and be manipulated via pop-up menus. 

Languages 

Compilers for C, Pascal, and Fortran 77; symbolic debugger dbx for C and F77 programs. 
Editing and Text Processing 

The vijex pair of editors for use with either line-oriented or full-screen terminals; include 
regular expression searching. document formatting facilities for line printer and 

phototypeset output. 

Program Development 

The Sun operating system provides a solid base for a flexible program development environ¬ 
ment. A powerful set of utilities allows full use of the UNIX-based (Berkeley 4.2) operating sys¬ 
tem. 

diff Compares two files and report differences. Checks C programs for syntax errors, 

type violations, and portability problems. 

make Indispensable tool for making sure that large programs are properly compiled with 
minimal effort through a control file specifying source file dependencies; knows about 
cc, yacc, lex and so on. Source Code Control System for maintaining and controlling 
multiple versions of text files. 

dhx A source level debugger for C programs. 

adh Low-level symbolic debugger; examine arbitrary files with no limit on size; interac¬ 

tive breakpoint debugging with the debugger as a separate process; symbolic refer¬ 
ence to local and global variables; patching; stack trace for C programs; and output 
formats of: 1-, 2-, or 4-byte integers in octal, decimal, or hex; single and double float¬ 
ing point; character and string; and disassembled machine instructions. 
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yacc 

ar 


at 


od 

Id 

nm 

size 

strip 

time 

prof 


A parser generator for BNF grammars. 

Maintain archives and libraries; combine several files into one for housekeeping 
efficiency; create new archive; update archive by date; replace or delete files; print 
table of contents; and retrieve from archive. 

Call assembler to create object program consisting normally of read-only and shar- 
able code, initialized data or read-write code, uninitialized data; relocatable object 
code is directly executable without further transformation; object code normally 
includes a symbol table; ‘conditional jump’ instructions become branches or branches 
plus jumps depending on distance; searching for integer, character, or fioating pat¬ 
terns. 

Dump any file; output options include any combination of octal or decimal or hex by 
words, octal by bytes, ASCII, opcodes, hexadecimal; range of dumping is controll¬ 
able. 

Link edit; combine relocatable object files. Insert required routines from specified 
libraries; resulting code is sharable by default. 

Print the namelist (symbol table) of an object program; provide control over the 
style and order of names that are printed. 

Report the memory requirements of one or more object files. 

Remove the relocation and symbol table information from an object file to save 
space. 

Report timing information on a command execution. 

Construct a profile of time spent per routine from statistics gathered by time¬ 
sampling the execution of a program; subroutine call frequency and average times for 
C programs. 


Graphics Tools and the Window System 


Pixrects Device-independent interface to pixel operations. 

SunWindows 

A tool for overlapping windows, including imaging control, creation and manipula¬ 
tion of windows and distribution of user inputs. 

Sitntools A multi-window executive and application environment supporting pop-up menus, 
icons and combined text and graphics. 

Icon Tool Simple bit-map editor. 

Communication Facilities 

The Sun system provides an electronic mail facility, access to the USENET network, and facili¬ 
ties for transferring files to and from remote machines. Some of these facilities include: 

mail Mail a message to one or more users; read and dispose of each message individually; 

the presence of mail is announced by login and optionally by esh; save messages in 
files or forward them; and support for items such as ‘Subject:’ and ‘Cc:’ fields. 

network news 

Access to USENET news articles. 

tip Utility to establish full-duplex connection for logging in to remote UNIX systems via 

dialup lines; provide transparent interface to remote machine; transmit files; take 
remote input from local file or put remote output into local file. 

UUCP Perform spooled file transfers between two UNIX machines; provide automatic queu¬ 
ing until line becomes available and remote machine is up; copy between two remote 


Revision C of 7 January 1984 


7-3 






Sun System Summary 


Beginner 9 Guide 


machines. 

write Establish direct workstation or terminal communication with another user. 
wall Write to all users. 

mesg Inhibit receipt of messages from write and wall. 

calendar Provide automatic reminder service for events of today and tomorrow. 

User Access Control Facilities 

Commands include: 

login Sign on as a new user; verify password and establish user*8 individual and group 
(project) identity; adapt to characteristics of a terminal; establish working directory; 
announce presence of mail; publish message of the day; execute user-specified profile; 
start command interpreter or other initial program. 

rlogin Log in to another machine. 

rwho See who is logged in on the local network. 

pastwd Change,a password; user can change his own password; passwords are encrypted for 
security. 

File Manipulation Facilities 
Commands include: 

cat Concatenate one or more files onto standard output; used for unadorned printing, 

for inserting data into a pipeline, and for buffering output that comes in dribs and 
drabs; and works on any file regardless of contents. 

cp Copy one file to another, or a set of files to a directory; works on any file regardless 

of contents; and can also copy directory hierarchies. 

rep Copy files and directories from other machines. 

emp Perform binary comparison. 

pr Prepare files for printing by a printer program; place title, date, and page number on 

every page; provide multicolumn output and parallel column merge of several files. 

Ipr Spool arbitrary files to printer for off-line printing; usually used in conjunction with 

pr. 

head Display first 'n’ lines of input. 

tail Display last *n' lines of input. 

split Split a large file into more manageable pieces. 

dd Translate physical file format for exchanging data with foreign systems. 

sum Sum the words of a file, providing convenient checksum. 

Directory and Filename Manipulation Facilities 

Commands include: 

rm Remove a file; only the name goes away if any other names are linked to the file; 

step through a directory deleting files interactively; and delete entire directory 
hierarchies. 

In ‘Link' another name or ‘alias' to an existing file. 

mv Move a file or files; rename files or directories; and move whole directory hierarchies. 

chmod Change permissions on one or more files; executable by files' owner. 

chgrp Change group (project) to which a file belongs. 
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mkdir Make a new directory. 

rmdir Remove a directory. 

ed Change working directory. 

find Prow! the directory hierarchy finding every file that meets specified criteria; perform 

specified command on each file found; criteria include: name matching a given pat¬ 
tern, creation date in given range, date of last use in given range, given permissions, 
given owner, given special file characteristics, or boolean combinations of above. 
Any directory may be considered to be the root. 

Running Programs 

Commands include: 

csh A flexible user interface, featuring a C-like command syntax, macro facilities, a his¬ 

tory facility for reissuing previous commands, and job control. The C-Sbell, the 
command language interpreter written at the University of California, Berkeley; sup¬ 
ply arguments to and run any executable program; redirect standard input, standard 
output, and standard error files; execute simultaneously the output of one process 
connected to the input of another through pipes; compose compound commands 
using: 

if ... then ••• else, 
case switches, 
while loops, 
for loops over lists, 
break, continue and exit, 
parentheses for grouping. 

initiate background processes; perform Shell programs, that is, command scripts with 
substitutable arguments; construct argument lists from all filenames satisfying 
specified patterns; take special action on traps and interrupts; provide user-settable 
search path for finding commands; execute user-settable profile upon login; option¬ 
ally announce presence of mail as it arrives; and provide variables and parameters 
with default setting. 

r$h Execute command on another system. 

sh The Bourne Shell, the UNIX version 7 command language interpreter. 

test Test for use in Shell conditionals; string comparison; file nature and accessibility; 

and boolean combinations of the above. 

ezpr Calculate command arguments with string computations; integer arithmetic; and 
pattern matching. 

wait Wait for termination of asynchronously running processes. 

echo Display remainder of command line; useful for diagnostics or prompts in Shell pro¬ 
grams, or for inserting data into a pipeline. 

sleep Suspend execution for a specified time. 

nohup Run a command immune to hanging up the workstation. 

nice Run a command in low or high priority. 

kiU Terminate named processes. 

at Schedule a one-shot action for an arbitrary time. 

tee Pass data between processes and divert a copy into one or more files. 
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System Manager’s Tools 

Automatic boot procedures to bring up Sun UNDC. Automatic reboot and file consistency checks 

and repair in the event of system crash. 

Commands include: 

conjig Configure and create bootable UNIX kernels with non'>8tandard hardware 
configurations. 

Become the super-user temporarily with all the rights and privileges thereof. 

ckown Change the ownership of one or more files. 

cron Schedule regular actions at specified times; actions are arbitrary programs; and times 
are conjunctions of month, day of month, day of week, hour and minute; ranges may 
be specified for each. 

mount Attach a device containing a file system to the tree of directories; protect agmnst 
nonsense arrangements. 

umount Remove the file system contained on a device from the tree of directories; protect 
against removing a busy device. 

mkfs Make a new file system on a device. 

newfs Provide front-end to mkfs. 

mknod Make an i-node (file system entry) for a special file; special files are physical devices, 
virtual devices, physical memory, etc. 

tar Manage file archives on magnetic tape; collect files into an archive; update tape 

archive by date; replace or delete tape files; print table of contents; and retrieve from 
archive. 

dump Dump the file system stored on a specified device, selectively by date, or indiscrim¬ 
inately. 

restore Replaces the old restor for restoring a dumped file system, or selectively retrieving 
parts thereof. 

fsck Interactive file system check and repair program; supersedes dcheek, ieheck, and 

ncheck; print gross statistics: number of files, number of directories, number of spe¬ 
cial files, space used, and free space; report duplicate use of space; retrieve lost space; 
report inaccessible files; check consistency of directories; and list names of all files. 

sync Force all outstanding I/O on the system to complete; used to shut down gracefully. 

Status Inquiry Commands 

Commands include: 

Is List the names of one, several, or all files in one or more directories; alphabetic or 

temporal sorting, up or down; and optional information: size, owner, group, date last 
modified, date last accessed, permissions, i-node number. 

file Determine what kind of information is in a file by consulting the file system index 

and by reading the file itself. 

date Display today's date and time; considerable knowledge of calendric and horological 
peculiarities; used to set system date and time. 

df Report amount of free space on file systems. 

du Display a summary of total space occupied by all files in a hierarchy. 

quota Display summary of disk usage and limits by user id. 


7-6 


Revision C of 7 January 1984 




Beginner s Guide 


Sun System Summary 


who List presently logged in users, ports and login times; provide optional history of all 

logins and logouts. 

p$ Report on active processes; list your own or everybody's processes; and provide 

optional status information: state and scheduling info, priority, attached terminal, 
what process is waiting for, and size. 

iostat Display statistics about system I/O activity. 

tty Display name of your terminal. 

pwd Display name of your working directory. 

System Accounting Facilities 
Commands include: 

«c Publish cumulative connect time report; connect time by user or by day and for all 

users or for selected users. 

#a Publish Shell accounting report; give usage information on each command executed, 

number of times used, total system time, user time and elapsed time, optional aver¬ 
ages and percentages, and sorting on various fields; note that the timing information 
on which the reports are based can be manually cleared or shut off completely. 

Workstation Handling Facilities 
Commands include: 

ttet Establish terminal characteristics for the environment. 

termcap Facility for customizing terminal parameters by terminal type. 
tah» Set tab stops appropriately for specified terminal type. 

9tty Set up options for optimal control of a terminal; determines half vs. full duplex, car¬ 

riage return plus line feed versus newline, tabs setting, parity, mapping of upper case 
to lower, raw versus edited input, and delays for tabs, newlines and carriage returns. 

Supported Languages and Related Programs 

C Programming Language 

The Sun operating system and most of the subsystems arc written in C; (for a full description of 
C, read The C Programming Language, Brian W. Kemighan and Dennis M. Ritchie, Prentice- 
Hall, 1978); general purpose language designed for structured programming; generalized initiali¬ 
zation, block structure, long integers, unions, and explicit type conversions; enhanced to take 
arbitrary length variable names, and has a substantially faster loader; supports definable data 
types, which include character, integer, float, double, pointers to all types, functions returning 
above types, arrays of all types, structures and unions of all types; operations intended to give 
machine-independent control of full machine facility, including to-memory operations and 
pointer arithmetic; macro preprocessor for parameterized code and inclusion of standard files; all 
procedures recursive, with parameters by value; machine-independent pointer manipulation; 
object code uses full addressing capability of the Sun Workstation; and runtime library gives 
access to all system facilities. 

cc Compile and/or link edit programs in the C language; C compiler has been enhanced to 
take arbitrary length variable names, allowing readable names and supporting other 
languages such as Pascal. It allows, for instance, the names from the standard to be 
used to implement core graphics. A substantially faster loader is also included, as well 
as tools to aid correction of errors which occur in programs by inserting the error mes¬ 
sages as comments into the source code so that the source can easily be edited to 
remove the errors; 
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lint Verifier for C programs; reports questionable or nonportable usage such as mismatched 
data declarations and procedure interfaces, nonportable type conversions, unused vari¬ 
ables, unreachable code, no-effect operations, mbtyped pointers, and obsolete syntax; 
full cross-module checking of separately compiled programs. 

cb A beautifier for C programs; does proper indentation and placement of braces. 

Fortran 

f77 A full compiler for the new ANSI Standard Fortran 77; compatible with C and 
supporting tools at object level; optional source compatibility with Fortran fid; 
free format source; optional subscript-range checking, detection of uninitialized 
variables; all widths of arithmetic: 2- and 4-byte integer; 4- and S-byte real; 8- 
and Ifi-byte complex. 

Ratfor Ratfor adds rational control structure like C*s to Fortran; compound 
statements; if-else, do, for, while, repeat-until, break, next statements; 
symbolic constants; file insertion; free format source; translation of rela- 
tionals like >, >»; produces genuine Fortran to carry away; may be 
used with F77, 

struct Converts ordinary Fortran into Ratfor, a structured dialect usable with 
/77, using statement grouping, if-else, while, for, and repeat-until. 

dc Interactive programmable desk calculator; has named storage locations as well as 

conventional stack for holding integers or programs; unlimited precision decimal 
arithmetic; appropriate treatment of decimal fractions; arbitrary input and output 
radices, in particular binary, octal, decimal and hexadecimal; reverse Polish opera¬ 
tors: 

+ -♦/ 

remainder, power, square root, load, store, duplicate, clear, 
print, enter program text, execute. 

be A C-Iike interactive interface to the desk calculator dc; all the capabilities of dc with 

a high-level syntax; arrays and recursive functions; immediate evaluation of expres¬ 
sions and evaluation of functions upon call; arbitrary precision elementary functions 
exp, sin, cos, atan; go-to-less programming. 

Pascal An ANSI Pascal compiler and interpreter system. 
pz Execution profiler 

pxref Cross-reference program for making cross-referenced listings of Pascal 
programs. 

Macroprocessing Utility 

m4 A general purpose stream-oriented macroprocessor that recognizes macros anywhere 

in text; syntax fits with functional syntax of most higher-level languages; can evalu¬ 
ate integer arithmetic expressions. 

Compiler-compiler# 

pace An LR(l)-based compiler writing system; during execution of resulting parsers, arbi¬ 
trary C functions may be called to do code generation or semantic actions; BNF syn¬ 
tax specifications; precedence relations; accepts formally ambiguous grammars with 
non-BNF resolution rules. 

lex Generator of lexical analyzers; converts specification of regular expressions and 

semantic actions into a recognizing subroutine; arbitrary 0 functions may be called 
upon isolation of each lexical token; full regular expression, plus left aiM right 
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context dependence; resulting lexical analyzers interface cleanly with yacc parsers. 

Text Editing and Document Formatting Tools 

ri The screen-oriented display editor, providing Vhat you see is what you get editing* 

for either line-oriented or full screen terminals. Capabilities include regular expres¬ 
sion searching and user-specific settings. 

ex The line-oriented parent of ts, based on the original td editor; subsumes all functions 

of td. 

awk A pattern scanning and processing language that makes it easy to specify many data 

transformation and selection operations. Pattern scanning and processing language; 
searches input for patterns, and performs actions on each line of input that satisfies 
the pattern; patterns include regular expressions, arithmetic and lexicographic condi¬ 
tions, boolean combinations and ranges of these; data treated as string or numeric as 
appropriate; can break input into fields; fields are variables; variables and arrays 
(with non-numeric subscripts); full set of arithmetic operators and control flow; mul¬ 
tiple output streams to fiiles and pipes; output can be formatted as desired; multi-line 
capabilities. 

$ed A non-interactive stream text editor version of td for processing large files; can per¬ 

form a sequence of editing operations on each line of an input stream of unbounded 
length; lines may be selected by address or range of addresses; provides control flow 
and conditional testing, multiple output streams, and multi-line capability. 

ed Interactive context editor; random access to all lines of a file; find lines by number or 

pattern; patterns may include specified characters, don*t care characters, choices 
among characters, repetitions of these constructs, beginning of line, and end of line; 
add, delete, change, copy, move or join lines; permute or split contents of a line; 
replace one or all instances of a pattern within a line; combine or split files; escape to 
the Shell command language during editing; do any of above operations on every 
pattern-selected line in a given range; optional encryption for extra security. 

ptx Make a permuted (key word in context) index. 

spell Look for spelling errors by comparing each word in a document against a 25,000- 

word list that includes proper names; handles common prefixes and suffixes; collects 
words to help tailor local spelling lists. 

look Search for words in dictionary that begin with specified prefix. 

crypt Encrypt and decrypt files for security. 

tr off SkJid nr off 

Troff drives a phototypesetter and can be used with appropriate conversion utilities 
to drive other types of devices; nroff drives ASCII terminals of all types; troff and 
nr off accept the same input language and are capable of elaborate formatting feats 
when appropriately programmed; completely definable page format keyed to dynami¬ 
cally planted interrupts* at specified lines; maintains several separately definable 
typesetting environments (for example, one for body text, one for footnotes, and one 
for unusually elaborate headings); arbitrary number of output pools can be combined 
at will; macros with substitutable arguments, and macros invocable in mid-line; com¬ 
putation and printing of numerical quantities; conditional execution of macros; tabu¬ 
lar layout facility; positions expressible in inches, centimeters, ems, points, machine 
units or arithmetic combinations thereof; access to character-width computation for 
unusually difficult layout problems; overstrikes, built-up brackets, horizontal and 
vertical line drawing; dynamic relative or absolute positioning and size selection. 
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globally or at the character leyei; can exploit the characteristics of the terminal 
being used, for approximating special characters, reverse motions, proportional spac¬ 
ing, etc; typesetter has a vocabulary of several 102-character fonts (4 simultaneously) 
in 15 sizes; troff provides terminal output for rough sampling of final output; nr off 
produces multicolumn output on the workstation (or terminal capable of reverse line 
feed), or through the col postprocessor. 

A standardized manuscript layout package of canned requests for use with nroff and 
iroffy provides page numbers and draft dates, automatically numbered subheads, 
footnotes, single or double column, paragraphing, display and indentation, and num¬ 
bered equations. 

A mathematical typesetting preprocessor for troff, translates easily readable formu¬ 
las, either in-line or displayed, into detailed typesetting instructions; formulas are 
written in a style like: 

sigma sup 2 1 over N sum from i**! to N ( x sub i - x bar ) sup 2 

to produce: 

4s (*.-?)* 

automatic calculation of size changes for subscripts, sub-subscripts, etc.; full vocabu¬ 
lary of Greek letters and special symbols, such as *gamma*, *GAMMA*, integral’; 
automatic calculation of large bracket sizes; vertical Spiling’ of formulae for matrices, 
conditional alternatives, etc.; integrals, sums, etc., with arbitrarily complex limits; 
diacriticals: dots, double dots, hats, bars, etc.; easily learned by nonprogrammers and 
mathematical typists. 

neqn A version of eqn for nroff, accepts the same input language; prepares formulas for 
workstation or terminal display; same facilities as eqn within graphical capability of 
workstation, 

A preprocessor for nrand troff thdX translates simple descriptions of tabic layouts 
and contents into detailed typesetting instructions; computes column widths; handles 
left- and right-justified columns, centered columns and decimal-point alignment; 
places column titles; table entries can be text, which is adjusted to fit; can box all or 
parts of table. 

Oanonicalize files with reverse line feeds for one-pass printing. 

Remove all troff commands from input. 

Check document for possible mismatched opening and closing delimiters and unk¬ 
nown commands. 

-me Another package of canned formatting requests. 

Information Handling Utilities 
Commands include: 

sort Sort or merge ASCII files line-by-line; no limit on input size; sort up or down; sort 

lexicographically or on numeric key; multiple keys located by delimiters or by chai> 
acter position; may sort upper case together with lower into dictionary order; option¬ 
ally suppress duplicate data. 

t$ort Topological sort converts a partial order into a total order. 

uniq Collapse successive duplicate lines in a file into one line; publish lines that were origi¬ 

nally unique, duplicated, or both; may give redundancy count for each line. 
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tr Do one-to-one character translation according to an arbitrary code; may coalesce 

selected repeated characters; may delete selected characters. 

diff Report line changes, additions and deletions necessary to bring two files into agree¬ 

ment; may produce an editor script to convert one file into another; a variant com¬ 
pares two new versions against one old one. 

comm Identify common lines in two sorted files; output in up to 3 columns shows lines 
present in first file only, present in both, and/or present in second only. 

Join Combine two files by joining records that have identical keys. 

grep Display all lines in a file that satisfy a pattern as used in the editor ed; may display 

all lines that fail to match, count of matches, and first match in each file. 

look Binary search in sorted file for lines with specified prefix. 

wc Count the lines, ‘words’ (blank-separated strings) and characters in a file. 

Novelties, Games, and Miscellaneous 

Commands include: 

backgammon 

Provides competition against a player of modest ability. 
bed Convert ASCII to card-image form. 

cal Display a calendar of specified month and year. 

Canfield Game of solitaire with betting. 

fortune Presents a random fortune cookie on each invocation; limited jar of cookies included. 

uniU Convert amounts between different scales of measurement; knows hundreds of units. 

arithmetic 

Speed and accuracy test for number facts. 
quiz Test your knowledge of Shakespeare, Presidents, capitals, etc. 

trump Hunt the wumpus, a thrilling search in a dangerous cave. 
hangman Word-guessing game using a dictionary supplied with $pelL 
fish Children’s card-guessing game. 

Sun Workstation Manuab 

System Manager's Manual for the Sun Workstation — Models lOOUjlSOU 

Includes system installation, configuration, boot, and maintenance procedures, mail system 
and networking facility set-up information, and a reference manual for commands and utili¬ 
ties of use to system managers. 

System Manager's Manual for the Sun Workstation — Model 180 

Includes system installation, configuration, boot, and maintenance procedures, mail system 
and networking facility set-up information, and a reference manual for commands and utili¬ 
ties of use to system managers. 

Beginner's Guide to the Sun Workstation 

A tutorial to the Sun system basics, along with user’s guides to the Shells, the mail and 
news systems, a glossary, and a bibliography for additional UNIX references. 

Editing and Text Processing on the Sun Workstation 

Contains user’s guides and reference material for the text editors and utilities, and docu¬ 
ment formatting programs and macro packages. 
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U»er*» Manual for the Sun Workstation 

Includes a documentation oYerview, user-oriented commands, demos, and games. 
Programmer's Reference Manual for SunWindows 

Contains reference material for programmers of applications which use window system facil¬ 
ities. 

Programmer's Reference Manual for SunCore 

Contains reference material for the SunCore graphics program. 

Fortran and Pascal on the Sun Workstation 

Fortran I/O libraries, and descriptions of Fortran interfaces to the UNIX system (section 
3F). Also includes the Pascal User’s Guide. 

System Interface Manual for the Sun Workstation 

Oriented towards programmers writing C-language programs. Contains descriptions of sys¬ 
tem calls, subroutines from various libraries, characteristics of special files (devices), and foiv 
mats of files. 

Programming Tools for the Sun Workstation 

Information of general interest to anyone using the Sun system to write programs. 

System Internals Manual for the Sun Workstation 

Contains papers on Sun system internals, including kernel debugging, network implementa¬ 
tion, and a device driver tutorial. 
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Preface — Part Two 


Part Two of the Beginner Guide to the Sun Workstation includes user’s guides to the Shells, 
the mail facility, the network news, a glossary and an annotated bibliography. The user’s 
guides provide details, examples and explanations of many of those commands and facilities 
presented in Part One. 

The Sun system supports two Shells, the OShell and the Bourne Shell. These Shells are more 
or less the same in basic essentials, but they vary a lot in detail. To provide complete, basic 
descriptions of both Shells, the Shell user’s guides in Part Two contain some material that is 
similar and even repetitious. For specific information on the Shells, see the csk and sk pages in 
the User^s Manual for the Sun Workstation. For detailed information on how to program the 
Shells, see the Programming Tools for the Sun Workstation . 

The chapters in Part Two are: 

1. Using the C*Shell — Introduces the C>Shell command interpreter and some commonly 
used Sun system commands. 

2. Using the Bourne Shell — Introduces the Version 7 UNIX Shell, the Bourne Shell. 

3. Mail User’s Guide — Provides details on the electronic mail facilities. 

4. Network News User’s Guide — Describes what the network news is, how to subscribe to 
newsgroups, how to read the news, and how to post your own news. 

5. Glossary — Provides brief definitions of terms and common commands. 

6. Bibliography — Provides an annotated list of Sun system and UNIX reference material. 

For additional details on any of the information presented In Part Two, refer to the User^s 
Manual for the Sun Workstation and to the System Interface Manual for the Sun Workstation, 
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Chapter 1 


Using the G-Shell 


Using the C-Shelfi^ introduces the basics of the C-Shcll first to give you a broad understanding 
its operation. Second, this guide provides more detailed information for learning to use the 
different C>Shell facilities. 

l.l* What is a Shell? 

A Shell is a program which provides you with interactive access to the operating system via a 
combined command and programming language. A Shell's primary purpose is to translate com¬ 
mand lines typed at the workstation into system actions, such as the invocation of other pro¬ 
grams. Because a Shell is a user program, just like any you might write, there is more than one 
available. The Shell you get when you log in is specified in your password file. 

Shell features include control-fiow primitives, parameter passing, and variable and string substi¬ 
tution. The Shell supports constructs such as whiltj if-then-elsCf casCf and for. Two-way com¬ 
munication is possible between the Shell and commands. String-valued parameters, typically 
filenames or fiags, may be passed to a command. Commands set a return code that may be 
used as Shell input. 

You can use the Shell to modify the environment in which commands run. You may redirect 
input and output to files, call processes that communicate through pipes, and define a directory 
searching sequence in the file system to call commands. Commands can be read either from the 
workstation or from a file, so command procedures can be stored in a file for later use. 

A Shell in the Sun operating system acts mostly as a medium through which other programs are 
invoked. While it has a set of built-in functions that it performs directly, most commands cause 
execution of programs that are external to the Shell. The Shell is thus distinguished from the 
command interpreters of other systems both by the fact that it is just a user program, and by 
the fact that it is used almost exclusively as a mechanism for invoking other programs. 

The Sun system supports two Shells, the C-Shell (esh) developed by William Joy at the Univer¬ 
sity of California at Berkeley and the Bourne Shell (sA) developed by S. R. Bourne at Bell 
Laboratories. After you log in to the Sun system, the C-Shell displays the prompt to indi¬ 
cate it is waiting for input. The Bourne Shell displays the prompt; this is an easy way to tell 
which Shell your system is running. The C-Shell permits its prompt to be modified and, in this 
guide, we show the prompt as ^tutorial%'. 
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The material in this chapter is derived from An Introduction to the C-Shell, William N. Joy. 
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1,2. C-Shell Commands 

Commands in the Sun system consist of a list of strings or words. They are interpreted as a 
command name followed by arguments. Thus the command: 

tutorial% mail sam 

consists of two words. The first word mail names the command to be executed, in this case the 
mail program, which sends messages to other users. The C-Shell uses the name of the command 
in attempting to execute it for you. It looks in a number of directories for a file with the name 
mailf which contains the mail program. 

The rest of the words of the command are given as arguments to the command itself when it is 
executed. In this case, the ar^ment is sam, which is interpreted by the mail program to be the 
name of a user to whom mail is to be sent. You can use the mail command as follows: 

tutorial^ mail sam 

Is the project meeting at 3K)0? 

I may have another appointment. 

Joe 

D 

EOT 

tutorial^ 

Here Joe sent the user ‘sam’ a message and ended his message with a which sent an end- 
of-file to the mail program. The mail program then echoed the characters ‘EOT’ and transmit¬ 
ted Joe’s message. The C-Shell displays the ‘tutorial^ ’ prompt before and after the mail com¬ 
mand to indicate that it is awaiting input. 

After displaying the ‘tutorial^’ prompt, the C-Shell reads command input from your worksta¬ 
tion. When you type a complete command such as mail sam^ the C-Shell executes the appropri¬ 
ate program, mail in this case, with an argument, sam. It then hands control over to the maiY 
program and waits for mail to complete. The mail program reads input from your workstation 
until you signal an end-of-file by typing a *D. This causes mail to complete; the Shell notices 
that mail has completed and displays another ‘tutorial^’ prompt to signal you that it is ready 
to read another command from the workstation again. 

This is the essential pattern of all interaction with the Sun system through the C-Shell. You 
type a complete command that the C-Shell executes. When this execution completes, the C- 
Shell prompts for a new command. If you run the editor for an hour, the C-Shell waits 
patiently for you to finish editing and obediently prompts you again when you finish. 

An example of a useful command you can execute now is the tset command, which sets the 
erase and kill characters on your terminal — the erase character erases the last character you 
typed, and the kill character erases the entire line you have entered so far. By default, the erase 
character is ‘DEL’ or ‘BACKTAB’, and the kill character is ‘^U’. You may prefer to use the 
backspace ("H) character as your erase character. You can make this change by using the tset 
command with the -c option: 


2 The notation "D is read ‘control-D’ and means that you should hold down the CONTROL (or 
CTRL) key while pressing the D key. The shift key is ignored so that ‘*d’ and ‘*D’ arc equivalent. 
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tutorial^ tset -e 
Erase set to Ctrl—H 
Kill is Ctrl—U 
tutorial^ 

This tells the program tset to set the erase character to "H. 


I.2.I. Specifying Optional Capabilities with Flag Arguments 

While many arguments to commands specify filenames or user names, some arguments called 
flag arguments specify an optional capability of a command that you wish to use. By conven* 
tion, such flag arguments begin with the character (hyphen). So, to produce a simple list of 
the files in the current working directory, use the U command: 

tutorial% b 

bin dead.letter disk.usage mboxmisc 
tutorial! 

The flag option -s is the size option, which gives the size of each file in blocks of 512 characters; 
for example: 

tutorial^ b -s 
total 9 

1 bin 1 dead.letter 1 disk.usage 
5 mbox 1 misc 
tutorial% 

shows the number of 512>character blocks in each file. Refer to the user’s manual for available 
options for each command. Some commands like the ts command have a large number of useful 
options, while other commands have either no options or only one or two. 


1.2.2* C-Shell Metacharacters 

The C-Shell has a number of special characters called metacharacters that have special func¬ 
tions. In general, most characters which are neither letters nor digits have special meaning to 
the C-Shell. There is a method of quoting that prevents the C-Shell from treating these metar 
characters in any special way. This notation is described in Quoting Away the Metacharacters. 

Metacharacters normally have effect only when the C-Shell is reading your input. You need not 
worry about placing C-Shell metacharacters in a letter you are sending with mail or when you 
are typing in text or data to some other program, for example. Note that the C-Shell is only 
reading input when it has prompted with ‘tutorial^’. See the C-Shell Metacharacters Summary 
for a complete list with meanings. 


1*2.3. Redirecting Output to Files with ‘>* 

Commands that normally read input from or write output to the workstation can instead be 
executed using a file rather than the workstation for input and output. The date command nor¬ 
mally displays the current date on your workstation screen because your screen is the default 
standard output for the date command: 
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tutorial^ date 

Thu Aug 4 10:58:37 PDT 1983 
tutorial^ 

Suppose you wish to save the current date in a file called todaff. You can redirect the standard 
output of a command through a notation using the metacharacter *>* to the today file rather 
than to the screen: 

tutorial^ date > today 
tutorial^ 

This command places the current date and time into the file today. Note that the date com¬ 
mand does not know that its output is going to a file rather than to the workstation. The 0- 
Shell sets up this redirection before the command begins executing. 

One other thing to note here is that the C-Shell creates the file if it does not exist. The file 
today need not have existed before date was executed. And if the file does exist, its previous 
contents are discarded. You can set the C-Shell option noclobber to prevent this from happen¬ 
ing accidentally; see the C-Shell Variables section on noclobber. 

The system normally keeps files that you create with ‘>* permanently. If you wish to create a 
file which will be removed automatically, begin its name with a the 'scratch^ character, to 
denote that the file will be a scratch file. The system removes such files after a couple of days, 
or sooner if file space becomes very tight. So if you don’t really want to save the output in the 
example above permanently, use the notation: 

tutorial^ date > #today 
tutorial^ 


1.2*4. Redirecting Input from Files with 

In the same way that you can redirect the standard output of a command to a file with *>’, 
you can also redirect the standard input of a command from a file with the *<’ character. This 
is not often necessary, however, since most commands read from a file whose name is given as 
an argument. Redirection of input to the sort command looks like: 

tutorial% sort < fruit 

apples 

bananas 

blueberries 

lemons 

limes 

nectarines 

oranges 

peaches 

pears 

plums 

strawberries 

tutorial^ 

where the command reads its input from the file fruit. You would more likely let sort open the 
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file fruit for input itself since this is less typing: 
tutorial% sort fruit 

apples 
bananas 
< etc. > 
plums 

strawberries 

tutorial^ 

Note that if you just type tort and do not redirect the standard input, as in: 
tutorial^ sort 

the tort program sorts lines from its standard input, the workstation, taking what you type as 
data, until you type a "D to indicate an end-of-file. The default standard inpur for programs 
comes from the workstation keyboard. 

I.2.5. Chaining Commands in a Pipeline 

In the C-Shell, you can connect the standard output of one command to the standard input of 
another; that is, you can run the commands in a sequence known as a pipdme. For instance, 
the It command with the -s option normally produces a list of the files in your directory with 
the size of each in 512-character blocks: 

tutorial^ Is -s 
total 388 

1 Makefile 286 doc.tbUO gloss 
56 mail.all 5 refs.all 
tutorial^ 

If you are interested in learning which of your files is largest, you want to sort the list by size. 
You can look at the many h options to see if there is an option to do this, but you would even- 
tuaUy discover that there is not. 

Instead you can use a couple of simple tort options and combine them with U with the nota¬ 
tion to invoke the pipe mechanism to get what you want. Thus, you can pipe It to tort by typ¬ 
ing: 

tutorial^ Is -s | sort -n 
total 388 

1 Makefile 5 refs.all 40 gloss 

56 mail.all 286 doc.tbl 

tutorial% 

This runs the It command with the option -s and pipet this It output to the tort command with 
the numeric option —n. Your list of files is sorted by size with the smallest first. You can then 
use the -r reverse tort option and the head command in conjunction with the previous com¬ 
mand: 
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tutorial^ Is -s | sort -n -r | bend -S 

286 doc.tbl 

56 mail.all 

40 gloss 

tutorial% 

Here you take a list of your files sorted alphabetically, each with the size in blocks. You pipe 
this to the standard input of tort asking it to sort numerically in reverse order, that is, largest 
first. This output is then piped into the head command, which shows you the first few lines. In 
this case you ask head for the first three lines. Thus this pipeline gives you the names and sires 
of your three largest files. 

The C-Shell connects commands separated by ‘p characters, and the standard output of each is 
run into the standard input of the next. The leftmost command in a pipeline normally takes its 
standard input from the workstation keyboard, and the rightmost normally sends its standard 
output to the workstation screen. Other examples of pipelines are provided later in the descrip¬ 
tion of foreground and background jobs. 


1.2.6* Pathnames and Filenames 

Sun system pathnames consist of a number of components separated by a slash Each com¬ 
ponent, except the last, names a directory in which the next component resides, in effect speci¬ 
fying the path of directories to follow to gain access to the file. Thus the pathname: 

fetcjmotd 

specifies a file in the directory /cfc, which is a subdirectory of the root directory 7’* Within this 
directory the file named is mofd, the ‘message of the day’ file. A pathname that begins with a 
slash is said to be an absolute pathname since it specifies a complete path from the absolute top 
of the directory hierarchy of the system, the root. Pathnames which do not begin with 7’ ^irc 
interpreted as starting in the current working directory^ which is by default, your home directory 
and which you can change dynamically with the cd (change directory) command. Such path¬ 
names are said to be relative to the working directory since they are found by starting in the 
working directory and descending to lower levels of directories for each component of the path¬ 
name. If the pathname does not contain any slashes at all, the file is contained in the working 
directory itself, and the pathname is merely the name of the file in this directory. Absolute 
pathnames have no relation to the working directory. 

Most filenames consist of a number of alphanumeric characters and ‘.’s (dots). In fact, filenames 
can have all printing characters except ‘/’. Remember that it is inconvenient to have most 
non-alphabetic characters in filenames because many of these characters are metacharacters that 
have special meaning to the C-Shell. The character (dot) is not a C-Shell metacharacter and 
often separates the extension of a filename from the base of the name. Consider the following 
four related files: 

data.c data.o data.errs data.output 

The files share a base portion, ‘data’, of a name and have different extensions, ‘c’, ‘o’, ‘errs’, and 
‘output’. The file data.c might be the source for a C program, the file data.o the corresponding 
object file, the file data.errs the errors resulting from a compilation of the program, and the file 
data.output the output of a run of the program. 
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1.2.7. Filename Expansion — ‘T’ ‘[ ]’ * ’ }’ 

If you want to refer to all four of these files in a command, use the notation, which the 0* 
Shell expands to match any sequence, including the empty sequence, of characters in a filename. 
For example, if you use: 

data.* 

the C-Shell expands this word into a list of names which begin with *data* before executing the 
command to which it is an argument. The names that match data. * are alphabetically sorted 
and placed in the argument list of the command. Thus the echo command and this notation 
display the four related files as: 

tutorial^ echo data.* 

data.c data.errs data.o data.output 

tutorial% 

Note that the names are in sorted order here and a different order than you listed them above. 
The echo command receives four words as arguments, even though you only directly type one 
word as an argument. Filename expansion of the one input word, data.* generates the four 
words. 

As matches any sequence of characters in a filename, the character matches any single 
character in a filename. So, to echo a line of filenames, type: 

tutorial^ echo ? ?? ??T 

This echoes first those with one-character names, then those with two-character names, and 
finally those with three- character names. The names of each length are independently sorted. 

Another mechanism matches any single character from a sequence of characters between *( ]’. 
So to match: 

data.c data.o 

in the example above, use: 

tutorial^ echo data.[co] 
data.c data.o 
tutorial% 

You can also place two characters around a in the *[ J’ notation to denote a range. Thus to 
match: 

chap.l chap.2 chap.3 chap.4 chap.5 

if they exist, use: 

tutorial% echo chap.[l-6] 
chap.l chap.2 chap.3 chap.4 chap.5 
tutorial^ 

This is shorthand for 
chap.[l2345] 

and otherwise equivalent. 

Note that if a list of arguments to a command, that is, an argument list, contains filename 
expansion syntax that fails to match any existing filenames, the C-Shell considers this to be an 
error and displays the diagnostic: 
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No match. 

and does not execute the command. 

Another important point is that files with the character (dot) at the beginning of their names 
are specially treated. Neither nor the ‘[ ]’ mechanism matches it. This special treatment 

prevents accidental matching of the filenames and in the working directory; these files 
have special meaning to the system. 

Another filename expansion mechanism gives access to the pathname of the home directory of 
other users. This notation consists of the character (tilde) followed by another user’s login 
name. For instance, "tarn maps to the pathname jiurlsam if the home directory for ‘sam’ is 
/wrjtam. Use this notation when you need to gain access to other users’ files in directories 
with different prefix directory names. It’s an easier and more reliable method than typing out 
the entire pathname. 

A special case of this notation consists of a alone, such as “/m6a*. The C-Shcll expands this 
notation into the file mboz in your home directory, that is, into lutrjsam/mbox for your fellow 
user Sam. This is very useful if Sam uses cd to change to another directory and finds a file he 
wants to copy to his home directory using cp. The C-Shell expands into fuirltamf Sam’s 
home directory, and copies the file thatstuff there if *sam’ types: 

tutorial^ cd programs 
tutorial^ pwd 
/ usr/sam/programs 
tutorial^ cp thatstuff 
tutorial^ cd 
tutorial^ Is 
thatstuff 
tutorial% 

Another form of filename expansion uses the characters *{ Braces specify that the contained 
strings, separated by a comma ( , ) are to be consecutively substituted into the containing char¬ 
acters and the results expanded left to right. So, you can abbreviate a set of words that have 
common parts but cannot be abbreviated by the above mechanisms because they are not files, 
or because they are the names of files which do not yet exist. Thus: 

A{strl,str2,...strn}B 

expands to: 

AstrlB Astr2B ... AstrnB 

The contained strings ‘strl,str2...stm’ are consecutively substituted into the containing charac¬ 
ters ‘A’ and ‘B’ and expanded left to right. This expansion occurs before the other filename 
expansions, and may be applied recursively, that is, nested. The results of each expanded string 
are sorted separately, left to right order being preserved. If the resulting filenames don’t exist, 
they are created if you don’t use other expansion mechanisms. You can use this mechanism to 
generate arguments which are not filenames, but which have common parts. A typical use 
below makes subdirectories docs, memos and letters in your home directory: 

tutorial^ mkdir ~/{docs,memos,letters} 

tutorial^ Is 

docs letters memos 

tutorial^ 

This mechanism is most useful when the common prefix is longer than in this example, for 
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instance, to list all the directories below without typing each individually, use the mechan¬ 
ism: 

tutorial% Is {/bin/t /usr/ucb/} {pi, wherels} 

/bin/pi 
/bin/whereis 
/usr/ucb/pi 
/usr/ucb/w hereis 
tutorial% 

See the C-Sheli Metacharacten Summary for a quick reference list of these characters. 

I.2.8. Quoting Away the Metacharacters 

Because the C-Shell uses these metacharacters for special purposes, you cannot use them 
directly as parts of words. If you try to use the echo command and as its argument, it 
doesn't work properly because of the special significance of Thus the echo command does 
not show the character 

tutorial^ echo * 

It either echos a sorted list of filenames in the current working directory, or displays the mes¬ 
sage *No match.' if there are no files in the working directory. 

To place characters that are neither numbers, digits, */*» “or si® argument word to a 
command, enclose them with single quotation characters For example, to quote away the 
special meaning of type; 

tutorial^ echo ' 

* 

tutorial^ 

Here the echo command displays the **' character, and ignores any special meaning. 

There is one special character '!' that the history mechanism uses and that you cannot escape by 
placing within ‘'' characters. Precede ‘I' and the character ‘'' itself by a single * \' to prevent 
their special meanings. So to echo ‘' !*, use: 

tutorial^ echo \' \! 

'I 

tutorial^ 

With these two mechanisms, you can place any printing character into a word which is an argu¬ 
ment to a C-Shell command. You can combine the two mechanisms, as in: 

tutorial^ echo \ ' 

tutorial^ 

The first *\' escapes the first *, and the *♦' was enclosed between ' characters, so neither 
retained its special meaning to the C-Shell. 
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I.2.9. How to Terminate C-Shell Commands 

When the C-Shell is waiting for an executing command to complete, there are several ways to 
stop that command. For instance, if you list all system users with the cat command: 

tutorial% cat /etc/passwd 

bugs:nologin:7;10:bug reporting:/usr/bugs:/dev/null 
prot:ZSMXceOkDv9hw:11:10:Vic Prot:/usr/prot:/bin/csh 
< etc. > 

sam:Iu2nX.wzcjYBo:953:10:Sam Brown:/usr/sam:/bin/csh 
rjb:9rYbUmD9JrJvw:954:20:Robert Baker:/u8r/rjb:/bin/csh 
tutorial^^ 

this list is likely to continue scrolling off your screen for several seconds unless you stop it. You 
can send an INTERRUPT signal to the cat command by typing *C (or the DEL or RUBOUT 
key if that's the way your keyboard is set up). Since the cat command does not take any pre¬ 
cautions to avoid or otherwise handle this signal, the terminates cat The C-Shell notices 
that cat has terminated and prompts you again with *tutorial%'. If you type a *0 again, the 
Shell just repeats its prompt since it ignores INTERRUPT signals and continues executing com¬ 
mands rather than terminating like cat did. Terminating at this point would otherwise have 
the effect of logging you out. 

Many programs terminate when they get an end-of-file from their standard input. Thus, you 
terminated this mail program in the first example above by typing a *D, which generates an 
end-of-file from the standard input. The C-Shell also terminates when it gets an end-of-file and 
displays ‘logout’; the Sun operating system then logs you off the system. Since this means that 
typing too many *D’s can accidentally log you off, the C-Shell provides a mechanism to prevent 
this. See the ijnorceo/description in the C-Shell Variables section. 

If you redirect a command’s standard input from a file, the command normally terminates when 
it reaches the end of that file. So if you redirect input to the mail command with: 

tutorial^ mail sam < doc.text 
tutorial^ 

mail terminates without your typing a *D because it reads to the end-of-file of your file doc.text 
You can also use the pipe mechanism to pipe the standard output of the eat command to the 
mail command: 

tutorial^ cat doc.text | mail sam 
tutorial% 

The cat command then writes the text through the pipe to the standard input of the mail com¬ 
mand. When cat completes, it terminates, closing down the pipeline, and the mail command 
receives an end-of-file from it and terminates also. Using a pipe here is more complicated than 
redirecting input, so use the first form. Typing also stops both of these commands. 

Another way to stop a command is to suspend its execution temporarily, with the possibility of 
continuing execution later. Do this by sending a STOP signal with *Z. This signal suspends all 
running commands, but there may be more than one if a pipeline is executing. The C-Shell 
notices that the command(s) have been suspended, displays ‘Stopped’ and then prompts for a 
new command. The previously executing command has been suspended, but is otherwise 
unaffected by the STOP signal. Any other commands can be executed while the original com¬ 
mand remains suspended. You can then continue the suspended command using the fg (fore¬ 
ground) command without any arguments. The C-Shell redisplays the command to remind you 
which command is being continued, and resumes the command execution. The suspension has 
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no effect whatsoever on the execution of the command unless the input files that the suspended 
command is using have been changed in the meantime. Suspending commands can be very use¬ 
ful during editing, when you need to look at another file before continuing. An example of com¬ 
mand suspension follows: 

tutorial^ mall peter 

You can copy the source from the directory named 
Z 

Stopped 

tutorial^ Is 

data.c 

data.o 

muchstuff 

tutorial^ jobs 

(ij + Stopped Mail peter 

tutorial% fg 

Mail peter 

(continue) 

data.c. Let’s dbcuss the project later. 

D 

EOT 

tutorial^ 

In this example you send a message to Peter but forget the name of the file you want to men¬ 
tion. You stop the mail command by typing "Z. When the C-Shell notices that mail is 
suspended, it displays ‘Stopped’ and prompts for a new command. You then use the Is com¬ 
mand to find out the name of the file. You then type the jobs command to see which command 
was suspended, mail peter in this case. You type the fg command to continue mail execution. 
Input to the mail program is then continued and ended with a "D which indicates the end of 
the message. Mail displays EOT for end-of-transmission. 

Type *Z only at the beginning of a line since everything typed on that current line is discarded 
when a signal is sent from the keyboard. This also happens with the 'C (INTERRUPT) and *\ 
(QUIT) signals. See the section on Running Jobs for more information on suspending and con¬ 
trolling jobs. 

If you write or run programs which are not fully debugged, it may be necessary to stop them 
somewhat ungracefully. Send them a QUIT signal by typing a *\. This usually provokes the 
C-Shell to produce a message like: 

Quit (Core dumped) 

indicating that a file core has been created containing information about the program’s state 
when it was terminated by the QUIT signal. You can examine this core file yourself using a 
debugger, or forward information to the maintainer of the program telling him where the core 
file is. 

When you run background commands, they ignore INTERRUPT and QUIT signals at the 
workstation. To stop the background commands, you must use the kill command. See the 
Running Jobs section for an explanation and examples. 

If you want to examine the output of a command without having it zip off the screen as the 
output of the cat command below does: 

tutorial^ cat /etc/passwd 
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use the more paging command to display it a page at a time: 
tutorial^ more /ctc/passwd 

The more program pauses after each complete screenful and displays ‘—More—’ at which point 
you can type a space to get another screenful, press RETURN to get another line, or type a 
to end more. You can also use more as a filter through which to pipe the cat command: 

tutorial^ cat /etc/pasawd | more 

This works just like the simple more command above. 

For stopping output of commands not involving more, use the *S key to stop the typeout. The 
typeout resumes when you type *Q. Typing "S and "Q works well on low-speed terminals, but 
use more if you find it hard to type "S and *Q fast enough to paginate the output nicely. 

You can also use the *0 flush output character. Typing *0 quickly throws away or ^flushes* all 
output from the current command until the next input read occurs or until the next Shell 
prompt. Use "O to complete a command’s execution without your having to suffer through the 
output on a slow terminal. Typing " O toggles output flushing on and off. 


1.2.10. Changing Shells 

If you are running the C-Shell, log in normally and follow the examples provided in the C-Shetl 
Detaih section. 

If you are not running the C-Shell when you log in, you are using the Bourne Shell, Ihinjoh or 
»h. In fact, much of the above discussion is applicable to Ibinlthy as is noted in Using the 
Bourne Shell in Part Two. 

If you are not using the C-Shell now, log in and change to the C-Shell with the csh command: 

$ csh 

tutorial^ 

To change back to the Bourne Shell, use the sh command: 

tutorial^ sh 

$ 


1.3. C-Shell Details 

This section describes more advanced features and details of the C-Shell. 


1.3.1. Starting and Terminating the C-Shell 

When you log in, the system starts the C-Shell running in your home directory. The C-Shell 
begins by reading commands from the ,cahre file in this directory. All Shells which you may 
start during your workstation session read from this file. You can put specific commands there 
that are described later. For now, however, you do not need this file, and the C-Shell does not 
complain about its absence. 

This first C-Shell is called the login Shell. This login Shell reads commands from .cshrc, after 
which it reads commands from a file called .login, also in your home directory. This .login file 
contains commands which you wish to execute once each time you log in to the system. A 
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Jogin file looks something like: 
set ignoreeof 

setenv EXINIT ’set noai wrapmargin=8’ 
set path=(. /usr/ucb /bin /usr/bin) 
set maii=(/nsr/spool/mail/sam) 

The first is a set command, which the C>Shell interprets directly. Set turns on the C-Shell vari’ 
able ignoreeofy which prevents the C-Shcll from logging you out if you type *D. Rather, you 
use the logout command to log off the system. 

The setenv command sets the value of an environment variabUy in this case to use the editors ez 
and vi without automatic cursor indentation {set noai) and with an automatic cursor return or 
*wrap’ to the left side of the screen eight columns from the right screen edge [wrapmargin^^S), 

The path variable defines the search path through which the OShell looks for files and pro¬ 
grams. The mail variable sets the location of the user Sam’s system mailbox. When the mail 
program finishes checking for your mail, the C-Shell finishes processing your .login file and 
begins reading commands from the workstation, prompting for each with "tutorial^*. When 
you log off with ''D, the C-Shell displays logout’ and executes commands from the file .logout it 
it exists in your home directoiy. After that the C-Shell terminates, and you are logged off the 
system. You then receive a new login message. In any case, after you type logout, the C-Shell 
is committed to terminating and will take no further input from your keyboard. 


1.3.2. C-Shell Variables 

The C-Shell maintains a set of variables. Each C-Shell variable has an array of zero or more 
strings as its value. Use the set command to assign values to C-Shell variables. Set has several 
forms, the most useful of which was already given above in the .login example as: 

set name= value 

C-Shell variables may store values which are used in commands later through a substitution 
mechanism. However, the most commonly used C-Shell variables are those which the C-Shell 
itself refers to. By changing the values of these variables called built-in variables, you can 
directly affect the C-Shell’s behavior. 

One of the most important variables is pathy which contains a sequence of directory names 
where the C-Shell searches for commands. The set command without an argument shows the 
value of all variables currently defined or ‘set’ in the C-Shell. You can sec what the default 
value for path is by typing the set command: 
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tutorial^ set 
argv 0 

cwd /usr/sam 

history 30 

home /usr/sam 

mail (/usr/spool/mail/sam) 

path (. /usr/ucb /bin /usr/bin) 

prompt tutorial^ 

shell /bin/csh 

status 0 

term sun 

user sam 

tutorial^ 

This output indicates that the variable path points to the current directory, symboliEed by 
(dot) and then luirfucb, /bin and /un/bin. Commands developed at the University of Califor¬ 
nia at Berkeley live in /utr/ucby while commands developed at Bell Laboratories live in /bin and 
/ usr/ bin. 

A number of locally developed programs on the system live in the directory /u$r/local If you 
want all Shells which you invoke to have access to these new programs, place the command: 

set path=(. /usr/ucb /bin /usr/bin /usr/local) 

in your file .login in your home directory. Try doing this, and then log out and back in. Now 
type the set command again to see that the value assigned to path has changed: 

tutorial^ set 
argv 0 

cwd /usr/sam 

< etc.> 

path (. /usr/ucb /bin /usr/bin /usr/local) 

< etc. > 
user sam 
tutorial% 

Be aware that the C-Shell initially examines each directory in your path and determines which 
commands are contained there. Except for the current directory which the C-Shell treats 
specially, this means that if commands are added to a directory in your search path after you 
have started the C-Shell, the C-Shell will not necessarily find them. If you wish to use a com¬ 
mand which has been added in this way, use the rehash command to recompute the C-Shell’s 
internal hash table of command locations so that it finds the newly added command: 

tutorial^ rehash 
tutoriaI% 

If you do not run rehash, the hashing algorithm may tell the C-Shell that the command wasn't 
in that directory when the hash table was computed. Since the C-Shell has to look in the 
current directory on each command, it can always find commands in the current working 
directory. 

Other useful built-in variables are the variable home, which shows your home directory, cwd, 
which contains your current working directory, and the variable ignoreeof, which can be set in 
your .login file to tell the C-Shell not to exit when it receives an end-of-file from your keyboard. 
The variable ignoreeof \s one of several variables that only have the value set or unset. Thus, to 
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set this variable you simply type the following in your Jogin file: 
set ignoreeof 

If you type the character accidentally, you get the message ‘Use “logout” to logout/ Then 
use the logout command to terminate the login Shell. 

To unset the ignoreeof option temporarily for that login session, type: 

tutorial% unset ignoreeof 
tutorial % 

These actions do not give the ignoreeof variable a value, but none is desired or required. 

Another useful built-in C-Shell variable is the noelobber variable. If you use the metasyntax: 

> filename 

to redirect the standard output of a command, you normally overwrite and destroy the previous 
contents (if any) of the named file, here filename. Because of this, you may accidentally 
overwrite a valuable file. If you want to prevent the C-Shell from overwriting files in this way, 
add the noclobber variable to your .login file: 

set noclobber 

Then try to redirect date into the todag file: 

tutorial^ date > today 
today: File exists, 
tutorial^ 

Noclobber warns you if today already exists. If you really want to overwrite the contents of 
today, you can use the *!’ character to force the action: 

tutorial^ date >f today 
tutorial^ 

The ‘>!' is a special metasyntax indicating that clobbering the file is allowed. The space 
between the *!' and the filename today is critical here, as Mtoday^ would be an invocation of the 
history mechanism, and have a totally different effect. 

See esh in the user^s manual for set variables. 

1.3.3. The History Mechanism 

The C-Shell can maintain a history list into which it places the words of previous commands. 
You can reuse these commands or words from them to form new commands. You can also use 
history to repeat previous commands or to correct minor typing mistakes. 

To use the history mechanism, edit your .eshre file to contain: 

set lustory=30 
Then type: 

tutorial^ source .eshre 
tutorial^ 

to have the change take effect. Then after you have typed several commands, you see that typ¬ 
ing just history shows the contents of the history list: 


Revision D of 7 January 1984 


1-15 



Using the C-Shell 


Beginner's Guide 


tutorial/^ history 

1 Is 

2 mkdir misc 

4 cd misc 

5 vi tut.memo 

6 spell tut.memo > mem.sp & 

7 pwd 

8 cd supplements/tutorial 

9 history > hist.list 
tutorial^ 

You can use the numbers given with the history events to refer to previous events, which are 
difficult to refer to using the contextual mechanisms introduced above. For example, to reuse 
command number 8, type simply: 

tutorial% !8 
cd supplements/tutorial 
tutorial^ pwd 

/usr/sam /supplements/tutorial 
tutorial^ 

The figure gives a sample session involving typical history mechanism commands. 
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tutorial^ cat bug.c 
main() 

{ 

printf(” hello); 

} 

tutoria!% cc !l 
cc bug.c 

"bug-c*^, line 4: newline in string or char constant 

” bug.c”, line 5: syntax error 

tutorial^ ed !$ 

ed bug.c 

29 

4s/);/”&/p 

printf(” hello”); 


30 

q 

tutorial% !c 
cc bug.c 

tutorial^ a.oat 
hello tutorial^ !e 
ed bug.c 
30 

4s/lo/lo\\n/p 

printf(”hello\n”); 

w 

32 

q 

tutorial^ !c -o bug 

cc bug.c -o bug 

tutorial^ sice a.out bug 

a.out: 2784+364+ 1028 ** 4176b = 0x1050b 

bug: 2784+ 364+ 1028 *= 4176b ^ Ox 1050b 

tutorial^ Is -1 !• 

Is -1 a.out bug 

-rwxr-xr-x 1 bill 3932 Dec 19 09:41 a.out 

-rwxr-xr-x 1 bill 3932 Dec 19 09:42 bug 

tutorial^ bug 
hello 

tutorial^ num bug.c | spp 
spp: Command not found. 
tutorial% ^spp'^ssp 
num bug.c | ssp 
1 main() 

4 printf(” hcllo\n”); 

5 } 

tutorial% !! | Ipr 
num bug.c | ssp | Ipr 
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tutorial^ 


Figure 1-1: Sample history Use 

In this example you have a very simple O program, with a bug (or two) in the file bug.c, which 
you cat out on your workstation. You then try to run the C compiler on it, referring to the file 
again as meaning the last argument to the previous command. Here the is the history 
mechanism invocation metacharacter, and the *$’ stands for the last argument, by analogy to *$’ 
in the editor, which stands for the end of the line. The C-Shell echoes the command, as it 
would have been typed without use of the history mechanism, and then executes it. The compi¬ 
lation yields error diagnostics, so you now run the editor on the file you are trying to compile, 
fix the bug, and run the C compiler again. This time you refer to this command simply as Me’. 
This repeats the last command which started with the letter ‘c’. If you have used other com¬ 
mands starting with ‘c’ recently, you have to say ‘!cc’. Typing Mcc:p’ prints the last command 
starting with ‘cc’ without executing it, so you can check which previous command you want. 

After this recompilation, you run the resulting a,out file, and then note that there still is a bug, 
and run the editor again. After fixing the program you run the C compiler again, but tack onto 
the command an extra ‘-o bug’ telling the compiler to place the resultant binary in the file bug 
rather than a.out. In general, you can use the history mechanism anywhere in the formation of 
new commands, and you can place other characters before and after the substituted commands. 

You then run the size command to see how large the binary program images you have created 
are, and then an U -/ command with the same argument list, denoting the argument list 
Finally, you run the program bug to see that its output is indeed correct. 

To make a numbered listing of the program, you run the num command on the file bug,e. To 
remove blank lines in num output, you run the output through the filter ssp, but misspell it as 
‘spp’. To correct this you use a C-Shell substitute, placing the old text and new text between 
characters. Note that the symbols ‘f and are the same thing. This is similar to the sub¬ 
stitute command in the editor. Finally, you repeat the same command with ‘!!’, but send its 
output to the line printer. 

There are other mechanisms available for repeating commands. History displays a number of 
previous commands with numbers by which they can be referenced. There is a way to refer to a 
previous command by searching for a string which appeared in it, and there are other, ways to 
select arguments to include in a new command. Refer to the C-Shell pages in the User^s 
Manual for the Sun Workstation for a complete description. 


1.3.4. The Alias Mechanism 

The alias mechanism substitutes one string for another before the C-Shell executes it. Use the 
C-Shell’s alias mechanism to supply default arguments to commands, or to perform transforma¬ 
tions on commands and their arguments. The alias facility is similar to a macro facility. Some 
of the features obtained by aliasing can also be obtained using C-Shell command files, but these 
take place in another instance of the Shell and cannot directly affect the current Shell’s environ¬ 
ment or involve commands such as cd, which must be done in the current Shell. 

As an example, suppose that there is a new version of the mail program called neumiail on the 
system. You would rather use it than the standard mail program, which is called mail If you 
place the C-Shell command: 
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alias mail new mail 

in your .cahrc file, the C-Shell transforms an input line of the form 
tutorial^ mail sam 

into a call on newmaiL Suppose you want the command U to always show which list entries are 
subdirectories, which are files, and which are symbolic links to other directories, that is to 
always use a -F option. Put the following alias in your .eshrc file: 

alias Is Is -F 

If you then type /s, you actually use U -F: 
tutoriaI% Is 

bin/ lint.mss mboxmisc/ 

supplements/ 

You can also use: 

alias If Is -F 

to create a new command syntax If that calls Is -F. So, using this alias on the home directory 
of ‘sam’, you get: 

tutorial^ If "sam 

bin/ dead.letter mboxmisc/ 

supplements/ 

tutorial^ 

or a list of files and directories in lusr/sam with the —F indications of ‘/’ for a directory. 

Thus the alias mechanism creates short names for commands, provides default arguments, and 
defines new short commands in terms of other commands. You can also define aliases which 
contain multiple commands or pipelines, showing where the arguments to the original command 
are to be substituted using the facilities of the history mechanism. To call an Is command after 
each ed (change directory) command, use the alias: 

alias cd cd \!* ; Is ' 

Enclose the entire alias definition in ' characters to prevent most filename expansions from 
occurring and the character from being recognized as a metacharacter. The here is escaped 
with a \ to make it apply to the argument list of the aliased cd command itself rather than 
searching the history list for a previous command. The ‘\!*' here substitutes the entire argu¬ 
ment list to the pre-aliasing cd command without giving an error if there aren't any arguments. 
The separating commands indicates that one command is to be done and then the next. 
Remember to run the source command on your .cshrc file to have any changes you make take 
effect: 

tutorial^ source .cshrc 
tutorial% 

When you use this aliaSf it looks like: 
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tutorial^ cd /usr/games 

abuse bed cribbage mille scifi vorms 

adyenture boggle fish monop snakewump 

arithmetic 

< etc. > 

tutorial^ 

This cd command not only changes directories, here to /twr/pfluie#, but it also lists all the 
games available. 

Similarly to define a command which looks up its first argument in the password file, put in 
your xthre file: 

alias whois grep \V /etc/passwd' 

Then, when you type whoie plus a username, the C-Shell calls grep to look in the /etcipasewd 
file: 

tutorial^ whois alice 

alice:IBkUBlXESfxGY:55:20:Alice Smith:/usr/alice:/bin/csh 
tutorial^ 

Use the unaltas command at the *tutorial%^ prompt to remove aliases temporarily for that Shell 
session. 

Warning: the C-Shell currently reads the xshre file each time it starts up, so if you place a large 
number of commands there, the C-Shell will tend to start slowly. Try to limit the number of 
aliases to 10 or 15. 


1.3«5. The Redirection Notation ^>>’ and 

In addition to the standard output, commands also have a diagnostic outputy which is normally 
directed to the workstation screen even when the standard output is redirected to a file or a 
pipe. You occasionally may want to direct the diagnostic output along with the standard out¬ 
put. For instance, if you want to redirect the output of a long running command into a file and 
wish to have a record of any error diagnostic it produces, you can type: 

tutorial^ command >8c file 
tutorial% 

The here tells the C-Shell to route both the diagnostic output and the standard output 

into file. Use the command form command >&! file if noclobber is set and file already exists to 
overwrite file. 

Similarly you can route both standard and diagnostic output through the pipe to the line 
printer Ipr by typing: 

tutorial^ command |& Ipr 
tutorial^ 

Finally, to place standard output at the end of an existing file, type: 

tutorial^ command > > file 
tutorial^ 

If noclobber is set, an error message ‘file: No such file or directory.* results if file for example. 
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does not exist; otherwise the OShell creates the named file. The form command >>i file elim¬ 
inates the error condition if file does not exist when noclobber is set. 

1.3.6. Running Jobs in the Background, Foreground, or 
Suspended 

When one or more commands is typed together as a pipeline or as a sequence of commands 
separated by semicolons, the C*Shell creates a single job consisting of these commands together 
as a unit. Single commands without pipes or semicolons create the simplest jobs. Usually, 
every line typed to the OShell creates a job. Some lines that create jobs (one per line) are 

tutorial^ sort < data 
tutorial^ Is —s | sort -n | head —5 
tutorial^ mail harold 

The job is started as a background job if you type the metacharacter *&’ at the end of the com¬ 
mands. This means that the OShell does not wait for the command to complete but immedi¬ 
ately prompts for another. The job runs m the background at the same time that the OShell 
continues to read and execute normal jobs, called foreground jobs. Thus, to redirect the output 
of the du program to a file called diek.usage, for instance, type: 

tutorial% du > disk.usage & 

(1] 503 
tutorial% 

Du reports on the disk usage of your working directory, as well as any directories below it. This 
command sequence puts the output into the file disk.usagef and the Shell returns immediately 
with a prompt for the next command without waiting for du to finish. The du program contin¬ 
ues executing in the background until it finishes, even though you can type and execute more 
commands in the meantime. When a background job terminates, the C-Shell displays a mes¬ 
sage just before the next prompt telling you that the job has completed. In the following exam¬ 
ple, the du job finishes sometime during the execution of the motY command and its completion 
is reported just before the prompt after the mail job is finished. 

tutorial^ du > disk.usage & 

[1] 503 

tutorial^ mail sam 

How do you know when a background job is finished? 

D 

EOT 

[1] - Done du > disk.usage 
tutorial% 

If the job did not terminate normally, the ‘Done* message might say something else like 
‘Stopped.* If you want the terminations of background jobs to be reported at the time they 
occur, which may interrupt the output of other foreground jobs, you can set the notify variable 
in your .cshrc file. In the previous example this would mean that the ‘Done* message might 
have come right in the middle of the message to Sam. The STOP, INTERRUPT, or QUIT sig¬ 
nals mentioned earlier, when typed on the keyboard, do not affect background jobs. 

Until they terminate, jobs are recorded in a table inside the 0-Shell. The C-Shell remembers 
the command names, arguments and the process numbers of all commands in the job in this 
table as well as the working directory where the job was started. Each job in the table is either 
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running in the foreground with the C-Shcl! waiting for it to terminate, running in the back- 
ground, or suspended. Only one job can be running in the foreground at one time, but several 
jobs can be suspended or running in the background at once. As each job is started, it is 
assigned a small identifying number called the job number which you can use later to refer to 
the job in the commands described below. Job numbers remain the same until the job ter¬ 
minates and then are re-used. 

Before prompting you for another command, the C-Shell displays the background job’s number, 
as well as the process numbers of all its top-level commands. For example, if you run the fol¬ 
lowing command in the background by typing the ampersand character at the end: 

tutorial% Is -s | sort -n > filedlst & 

[2] 2034 2035 
tutorial^ 

the U program runs with the -s option, pipes this output to the sort program with the -n 
option, which puts its output into the file JileMst The at the end of the line starts these 
two programs together as a background job. After starting the job, the C-Shell displays the job 
number in brackets, 2 in this case, followed by the process number of each program started in 
the job. Then the C-Shell immediately prompts for a new command, leaving the job running 
simultaneously. 

As mentioned in the How to Terminate C-Shell Commands section, typing "Z suspends currently 
running foreground jobs. You can suspend a background job by using the stop command 
described below. When jobs are suspended, they merely stop any further progress until started 
again, either in the foreground or the background. The C-Shell notices when a job becomes 
stopped and reports this fact, much like it reports the termination of background jobs. Stop¬ 
ping a foreground job looks like: 

tutorial^ du > disk.usage 
Z 

Stopped 

tutorial^ 

The C-Shell displays the ‘Stopped’ message when it notices that the du program stopped. For 
background jobs, using the stop command, it is: 

tutorial^ sort disk.usage & 

[1] 2345 

tutorial% stop 

[l] + Stopped (signal) sort disk.usage 
tutorial^ 

The ‘(signal)’ indicates that the job has been stopped by an indirect signal, as opposed to being 
stopped by *Z. Suspending background jobs can be very useful when you need to temporarily 
change what you are doing, that is, execute other commands, and then return to the suspended 
job. Also, you can suspend foreground jobs and then continue them as background jobs using 
the bg command. Thus, you can continue other work and stop waiting for the foreground job 
to finish. For example: 
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tutorial^ du > diBk.usage 

Z 

Stopped 

tutorial^ bg 

[i] du > disk.usage & 

tutorial% 

starts du in the foreground, stops it before it finishes, then continues it in the background so 
you can execute more foreground commands. The bg command runs a suspended job in the 
background. It is usually used after stopping the currently running foreground job with the "Z 
STOP signal. The combination of the STOP signal and the bg command changes a foreground 
job into a background job. This is especially helpful when a foreground job ends up taking 
longer than you expected, and you wish you had started it in the background in the beginning. 

All job control commands can take an argument that identifies a particular job. Begin all job 
name arguments with the character since some of the job control commands also accept 
process numbers, as displayed by the po command. If you do not specify a job, a job control 
command uses the default job, that is, the current job. This current job is identified by a *+ * 
in the output of the jobs command, which shows which jobs you have. When only one job is 
stopped or running in the background as is the usual case, it is always the current job, so no 
argument is needed. If a job is stopped while running in the foreground, it becomes the current 
job and the existing current job becomes the previous job, identified by a *- in the jobs output. 
When the current job terminates, the previous job becomes the current job. When given, the 
argument is either *%-f which indicates the previous job, where # is the job number, 

‘%prer where pref is some unique prefix of the command name and arguments of one of the 
jobs, or followed by some string found in only one of the jobs. 

The jobs command displays the table of jobs, giving the job number, status (^Stopped' or ‘Run¬ 
ning*) and command name for each background or suspended job: 

tutorial^ du > disk.usage & 

[1] 3398 

tutorial^ Is -s | sort -n > myfile ft 

[2] 3405 

tutorial^ mail bill 

Stopped 
tutorial^ Jobs 

[1] - Running du > disk.usage 

[2] Running Is -s | sort -n > myfile 

[3] + Stopped mail bill 
tutorial^ 

With the -1 option the process numbers are also displayed: 
tutorial^ jobs -I 

[1] 3398 - Running du > disk.usage 

[ 2 ] 3405 Running Is -s | sort -n > myfile 

[3] + Stopped mail bill 
tutorial^ 

Continuing with the same series, you can use the fg command to bring the la job to the fore¬ 
ground: 
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tutorial^ fg %b 
Is -s I sort -n > myfile 
tutorial^ more myfile 

The fg (foreground) command runs a suspended or background job in the foreground. It res¬ 
tarts a previously suspended job or changes a background job to run in the foreground, allowing 
signals or input from the workstation. In the above example you use fg to change the U job 
from the background to the foreground since you want to wait for it to finish before looking at 
its output file. 

The 9top command suspends a background job. 
tutorial% stop 

[1]- Stopped (signal) du > disk.usage 
tutorial^ 

You can use the kiU command to terminate a background or suspended job immediately. In 
addition to job numbers, you can give it process numbers as arguments, as displayed by p«. 
Thus, in the above example, you can terminate the running du command with kilt 

tutorial/^ kill %1 

[1] Terminated du > disk.usage 

tutorial^ 

The notify command (not the set command variable mentioned earlier) reports termination of a 
specific job at the time the job finishes instead of waiting for the next prompt. 

If a job running in the background tries to read input from the workstation, it is automatically 
stopped. You can give input to the job, when you return such a job to the foreground. If 
desired, you can return the job to the background until it requests input again. This is illus¬ 
trated in the following sequence where the « (substitute) command in the text editor might take 
a long time: 

tutorial^ ed bigfile 
120000 

1 ,$s/thisword/thatword/ 

Stopped 
tutorial^ bg 
[1] ed bigfile & 
tutorial^ 

. , . some foreground commands 
[l] Stopped (tty input)ed bigfile 
tutorial% fg 
ed bigfile 
w 

120000 

q 

tutorial^ 

After you called the s command, you stopped the ed job with *Z, and then put it in the back¬ 
ground using bg. Sometime later when the t command was finished, ed tried to read another 
command and was stopped because jobs in the background cannot read from the workstation. 
Typing the fg command returned the ed job to the foreground where it could once again accept 
commands from the terminal. 
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To stop all background jobs when they are about to write output to the workstation, use the 
itty (set terminal output) command: 

tutorial^ stty tostop 
tutorial% 

This prevents messages from background jobs from interrupting foreground job output so you 
can run a job in the background without losing workstation output. You can also use it for 
interactive programs that sometimes have long periods without interaction. Thus each time a 
background job prompts for more input, it stops before the prompt. You run the job in the 
foreground using fg, give it more input and, if necessary, stop and return it to the background. 
This 9Uy command is a good thing to put in your .login file if you do not like output from back’ 
ground jobs interrupting your work. It can also reduce the need for redirecting the output of 
background jobs if the output is not very big: 

tutorial^ stty tostop 
tutorial^ wc hugefile & 

[1] 10387 

tutorial% ed text 
. .. some time later 

q 

[1] Stopped (tty output) wc hugefile 
tutorial^ fg %wc 
wc hugefile 

13371 30123 302577 
tutorial^ stty -tostop 
tutorial% 

Thus after some time the wc command, which counts the lines, words and characters in a file, 
had one line of output. When it tried to write this to the workstation it stopped. By restarting 
it in the foreground, it writes on the workstation exactly when you are ready to look at its out¬ 
put. Stty tootop allows bg job output to go to the workstation. Programs which attempt to 
change the mode of a terminal will also stop, whether or not tostop is set, as it would be very 
unpleasant to have a background job change the state of a terminal. 

Since the jobs command only displays jobs started in the currently executing C-Shell, it knows 
nothing about background jobs started in other login sessions or within C-Shell files. Use the ps 
command in this case to find out about background jobs not started in the current C-Shell. 

1.3.7* The C-Shell’s Working Directory 

As mentioned in Filenames and Pathnames^ the C-Shell is always in a particular working direc¬ 
tory. The cd (change directory) command changes the working directory of the C-Shell, that is, 
changes the directory you are located in. 

It is useful to make a directory for each project you wish to work on and to place all files 
related to that project in that directory. The mkdir command (make directory) creates a new 
directory. The pwd (print working directory) command reports the absolute pathname of the 
working directory of the C-Shell, that is, the directory you are located in. Thus in the example 
below, Sam creates and moves to the directory newpaperj where he might place a group of 
related files: 
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tutorial^ pwd 
/ usr/sam 

tutorial^ mkdir newpaper 
tutorial^ cd newpaper 
tutorial^ pwd 
/ usr/sam / newpaper 
tutorial^ 

No matter where you move to in a directory hierarchy, you can return to your home login direc¬ 
tory by typing cd without any arguments: 

tutorial% cd 
tutorial^ pwd 
/usr/sam 
tutorial% 

The name (dot dot) always means the directory above the current one in the hierarchy, so 
to change the C-Shell’s working directory to the one directly above the current one, use: 

tutorial^ cd .. 
tutorial^ pwd 
/usr 

tutorial^ 

The name can be used in any pathname. To change to the directory prograniB contained in 
the directory above the current one, type: 

tutorial^ cd ../programs 

If you have several directories for different projects under, say, your home directory, use this 
shorthand notation to switch easily between them. 

The C-Shell always remembers the pathname of its current working directory in the variable 
cwd. You can also request that the C-Shell remember the previous directory when you change 
to a new working directory. If you use the puskd (push directory) command in place of the cd 
command, the C-Shell saves the name of the current working directory on a directory stack 
before changing to the new one. You can see this directory stack at any time by typing the 
directories command dirs: 

tutorial% pushd newpaper/references 

~/new p aper/references 
tutorial^ pushd /usr/lib/tmac 
/usr/Iib/tmac "/newpaper/references 
tutorial^ dirs 

/usr/Iib/tmac "/newpaper/references 

tutorial^ 

tutorial^ 

The list is displayed in a horizontal line, reading left to right, with a tilde (~) as shorthand for 
your home directory — in this case I usr f earn. The directory stack is displayed whenever there 
is more than one entry in it and it changes. Dirs is usually faster and more informative than 
pwd since it shows the current working directory as well as any other directories remembered in 
the stack. The pushd command without any arguments alternates the current directory with 
the first directory in the list. 
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The popd (pop directory) command without an argument returns you to the directory you were 
in prior to the current one, discarding the current directory from the stack and forgetting it. 
Typing popd several times in a series takes you backward through the directories you had 
changed to with the pifsAd command: 

tutorial% pppd 
"/newpaper/references 
tutorial% popd 

tutorial^ 

There are other options to puehd and popd to manipulate the contents of the directory stack 
and to change to directories not at the top of the stack; see the coh user’s manual page for 
details. 

Regardless of what directory changes you make, the C-Shell remembers the working directory in 
which each job was started. It warns you if you try to restart a job in the foreground which has 
a different working directory than the current O-Shell working directory. Thus if you start a 
background job, change the C-ShelPs working directory, and then run the background job in 
the foreground, the C-Shell warns you that the working directory of the currently running fore¬ 
ground job is different from that of the C-Shell: 

tutorial% dirs-1 
/doc/sam 

tutorial^ cd myproject 
tutorial^ dIrs 
~/myproject 
tutorial^ ed prog.c 
1143 

Z 

Stopped 
tutorial% cd 
tutorial^ Is 
myproject 
textfile 
tutorial^ fg 

ed prog.c (wd: "/myproject) 

The C-Shell warns you that the working directory of the cd program is " f myprojecty not the 
current working directory of docisam. The ed job was still in jdocjaamjproject even though 
the C-Shell had changed to / doejoam. 

You get a similar warning when such a foreground job terminates or is suspended using the "Z 
STOP signal, since returning to the C-Shell again implies a change of working directory. 

tutorial^ fg 

ed prog.c (wd: "/myproject) 

. . . after some editing 

q 

(wd now: ~) 
tutorial^ 

These messages are sometimes confusing if you use programs that change their own working 
directories. The C-Shell only remembers which directory a job is started in, and assumes the 
job stays there. The jobs -1 option displays the working directory of suspended or background 
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jobs when it is different from the current working directory of the C-Shell. 


1.3.8. Useful Built-in Commands 

This section describes several of the more useful built-in C-Shell commands. For a complete 
list, see ah in the user’s manual. 

The echo command plays back its argument list to the screen. It is often used in Shell scripts or 
as an interactive command to see what filename expansions will produce. We saw this earlier in 
Filename Expansion. To determine the effect of a command such as rm, type: 

tutorial^ echo rm [caj* 

rm a aA aB aC cl clO ... c5 c6 c7 c8 c9 

tutorial^ 

Using echo here is a good way to learn the effects of the metacharacters without affecting any 
files or directories. 

The limit command restricts the use of resources. With no arguments, it displays the current 
limitations: 

tutorial^ limit 
filesize unlimited 

datasize 1984 kbytes 

stacksize 512 kbytes 

coredumpsize unlimited 
memory use unlimited 

tutorial^ 

Limits can be set, for instance: 

tutorial^ limit coredumpsize 128k 

tutorial^ 

for the current login session. Most reasonable units abbreviations work. See the esh user’s 
manual page for more details. 

Use repeat to repeat a command several times. To make four copies of the file data in the file 
/o«r, type: 

tutorial^ repeat 4 cat data > > four 
tutorial^ 

The setenv command sets variables in the environment. For example: 
setenv TERM sun 


or 

setenv TERM admSa 

This sets the value of the environment variable TERM to *sun’ or ‘admSa*, depending on your 
terminal. Unsclcnv removes variables from the environment. 

The printenv user program displays the environment. It might show: 
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tutorial^ prlntenv 

HOME==/usr/Iori 

SHELL=/bin/csh 

PATH=.:/:/bin:/usr/bin:/usr/lori/bin:/usr/Iocal:/usr/local/bin:/usr/ucb:/etc:/nsr/hosts 

TERM=sun 

USER-=lori 

EXINlT=set noai wrapmargin—8 
tutorial^ 

Use the source command noted before to force the current Shell to read commands from a file: 

tutorial% source .cshrc 
tutorial^ 

Running source on the .cshrc file makes any changes you made take effect immediately^ that is, 
before the next time you login. 

Use the time command to time a command no matter how much CPU time it takes: 

tutorial% time cp /ctc/rc /usr/sam/rc 
O.Ou 0.1s 0:01 S% 2+ Ik 3+ 2io lpf+ Ow 
tutorial^ time wc /ctc/rc /usr/sam/rc 
52 178 1347 /etc/rc 

52 178 1347 /usr/sam/rc 

104 356 2694 total 

O.lu 0.1s 0:00 13% 3+3k 5+3io 7pf+0w 

tutorial^ 

The first indicates that the cp command used a negligible amount of user time (u) and about 
1/lOth of a second system time (s); the elapsed time was 1 second (0:01); 8% of CPU cycles over 
period when active; there was an average memory usage of 2k bytes of program space and Ik 
bytes of data space over the CPU time involved (2+ Ik); the program did three disk reads and 
two disk writes (3+ 2io), took one page fault and was not swapped (lpf+ Ow). The word count 
command tre on the other hand used 0.1 seconds of user time and 0.1 seconds of system time in 
less than a second of elapsed time. The percentage ‘13%’ indicates that over the period when it 
was active, wc used an average of 13 percent of the available CPU cycles of the machine. 


1.4. Programming the C-Shell 

You can use the C-Shell to read and execute C-Shell command scripts. C-Shell scripts are files 
that contain a group of esh commands. 

A command script may be interpreted by saying: 
tutorial% esh script ••• 

where script is the name of the file containing a group of esh commands and ‘...’ is replaced by a 
sequence of arguments. The C-Shell places these arguments in the variable argv and then 
begins to read commands from the script. These parameters are then available through the 
same mechanisms which are used to reference any other C-Shell variables. 

You can make the file executable with the chmod command: 
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tutorial^ chmod 755 script 
tutorial% 

If you place a C-Shell comment at the beginning of the Shell script as well, that is, begin the file 
with a *#’ character, then jbin!ah is automatically invoked to execute script when you type: 

tutorial% script 

If the file does not begin with a then the standard Shell /6ffi/sA executes it. In this way, 
you can convert your older shell scripts to use ah, 

I.4.I. Variable Substitution 

After each input line is broken into words and history substitutions are done on it, the input 
line is parsed into distinct commands. Before each command is executed a mechanism known as 
variable substitution is done on these words. Keyed by the character this substitution 
replaces the names of variables by their values. Thus 

echo Sargv 

when placed in a command script echoes the current value of the variable argv to the output of 
the shell script. You must have arj^ set at this point; otherwise, it is an error. 

A number of notations are provided for accessing components and attributes of variables. The 
notation 

$?name 

expands to ‘U if name is set or to *0* if name is not set This is the fundamental mechanism 
used for checking whether particular variables have been assigned values. All other forms of 
reference to undefined variables cause errors. 

The notation 

$#name 

expands to the number of elements in the variable name. Thus 

tutorial/^ set argv=(& b c) 
tutorial^ echo $?argv 
1 

tutorial^ echo $#argv 
3 

tutorial^ unset argv 
tutorial^ echo $?argv 
0 

tutorial^ echo largv 
Undefined variable: argv. 
tutorial/^ 

It is also possible to access the components of a variable which has several values. Thus 
$argv[l] 

gives the first component of argv or in the example above ‘a\ Similarly 
$argv[$#argvl 
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would give ‘c*, and 
$argv(l-2l 

would give b*. Other notations useful in shell scripts are: 

where n is an integer as a shorthand for 
$argy|nj 

the nth parameter and 

$* 

which is a shorthand for 
$argv 
The form 

$1 

expands to the process number of the current Shell. Since this process number is unique in the 
system it can be used to generate unique temporary filenames. The form 

%< 

is quite special. It is replaced by the next line of input read from the ShelFs standard input, not 
the Shell script it is reading. This is useful for writing Shell scripts that are interactive, reading 
commands from the workstation or terminal, or even writing a Shell script that acts as a filter, 
reading lines from its input file. Thus the sequence 

echo -n Y®* or no?’ 
set a=($<) 

writes out the prompt or no?’ without a newline and then reads the answer into the van* 
able *a’. In this case ‘$#a’ would be ‘O’ if either a blank line or end-of-file (*D) is typed. 

There is one minor difference between ‘In’ and ‘largv[nl’. The form ‘$argv[n)’ will yield an 
error if n is not in the range ‘l-$#argv’, while ‘In’ will never yield an out of range subscript 
error. This is for compatibility with the way older shells handled parameters. 

Another important point is that it is never an error to give a subrange of the form ‘n-’; if there 
are less than n components of the given variable then no words are substituted. A range of the 
form ‘m-n’ likewise returns an empty vector without giving an error when m exceeds the 
number of elements of the given variable, provided the subscript n is in range. 

See Frogramming TooU for the Snn Workstation for more information on programming the C- 
Shell. 


1.5* C*Shell Metacharacter Summary 

The following table lists the special csh and Sun system characters. A number of these charac- 
ters abo have special meaning in expressions. See the esh manual section for a complete list. 
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Table 1-1: Syntactic Metacharacters 

; separates commands to be executed sequentially 

I separates commands in a pipeline 

( ) brackets expressions and variable values 

& follows commands to be executed without waiting for completion 

Table 1-2; Filename Metacharacters 

separates components of a file's pathname 
expansion character matching any single character 
expansion character matching any sequence of characters 
expansion sequence matching any single character from a set 
used at the beginning of a filename to indicate home directories 
used to specify groups of arguments with common parts 

Table 1-3: Quoting Metacharacters 

\ prevents meta-meaning of following single character 

prevents meta-meaning of a group of characters 
” like 'f but allows variable and command expansion 

Table 1-4: Input/output Metacharacters 

< indicates redirected input 

> indicates redirected output 

Table 1-5: Expansion/substitution Metacharacters 

indicates variable substitution 
indicates history substitution 
precedes substitution modifiers 
used in special forms of history substitution 
indicates command substitution 

Table 1-6: Other Metacharacters 

# begins scratch file names; indicates Shell comments 

prefixes option (flag) arguments to commands 
% prefixes job name specifications 
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Chapter 2 


Using the Bourne Shell 


Using ^kc Bourne Shelfi describes the UNIX system Ycrsion 7 Shell called the Bourne Shell (sh). 
The design of the Bourne Shell, here referred to simply as the ‘Shell,’ is based in part on the ori¬ 
ginal UNIX Shell and the PWB/UNDC Shell. Similarities also exist with the command interpreters 
of the Cambridge Multiple Access System and of OTSS. 

See the User *s Manual for the Sun Workstation for more details on sh. Also see the references in 
the appendix for more information. 


2.1. What b a Shell? 

A Shell is both a command language and a programming language that provides an interface to 
the operating system and interprets commands which you type. The Shell’s primary purpose is 
to translate command lines typed at the workstation into system actions, such as the invocation 
of other programs. Because the Shell is a user program, just like any you might write, there is 
more than one available. The Shell you get when you log in is specified in your password file 
entry field, which contains the pathname to it. 

The Shell’s features include variables, control-flow primitives, parameters passing, subroutines, 
interrupt handling, and string substitution. The Shell supports control structures such as whiles 
if-then-eisef case, and for. Two-way communication is possible between the Shell and commands. 
String-valued parameters, typically filenames or flags, may be passed to a command. Com¬ 
mands set a return code that may be used as Shell input. 

You can use the Shell to modify the environment in which commands run by redirecting input 
and output to files, by calling processes that communicate through pipes, and by defining a 
directory searching sequence in the file system to call commands. Commands can be read either 
from the workstation or from a file, so command procedures can be stored for later use. 

A Shell in the Sun operating system acts mostly as a medium through which other programs are 
invoked. The Shell is thus distinguished from the command interpreters of other systems both 
by the fact that it is just a user program, and by the fact that it is used almost exclusively as a 
mechanism for invoking other programs. 

The Sun system supports two shells, the Bourne Shell and the C-Shell, which are available as 
the programs csh and sA respectively. The Shell you get when you log in is specified in a field in 
your password file entry, which contains the pathname to the Shell to be used. If your system 
is running the Bourne Shell, it displays the ‘I’ prompt. The C-Shell displays the prompt. 


* The m&teri&l in this chapter is derived from An Introduction to the Bourne Shell, S. R. Bourne. 
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2«2. Logging In 

The Shell is a program that runs automatically when you log in to the Sun system. When you 
log in, the Shell reads any commands from the file .profile^ if you have such a file in your login 
directory before reading any commands from the workstation. 

It reads each command that you type and interprets what youVe asked for. The Shell expands 
any file-matching metacharacters you use. If you redirect the standard input and output, or the 
diagnostic output, the Shell handles that too. The Shell examines the command you type in, 
calls up the command from wherever it lives, and passes all the arguments to that program and 
starts it up. 

The Shell is the interface between you the user, and the Sun system utility programs. Because 
it is just an ordinary program, you can use it by typing the command sh followed by an argu¬ 
ment, which is the name of a file containing Sun system commands. See Programming the Shell 
for some simple examples. 


2.3. Changing the Shell Prompt 

The Shell displays a prompt before reading a command. By default this prompt is \ Or you 
can change it to the string *yesdear\ for example: 

PSl=yesdear 

If a newline is typed and further input is needed, the Shell displays the prompt *> \ Some¬ 
times mistyping a quote mark causes this. If it is unexpected, an INTERRUPT (*C) returns 
the Shell to read another command. You can change this *>’ prompt by saying, for example: 

PS2==more 


2.4. Simple Shell Commands 

Simple Shell commands consist of one or more words separated by blanks. The first word is the 
name of the command to be executed; any remaining words are passed as arguments to the 
command. These arguments can be flag arguments or filenames. For example, to print the 
names of users logged in, type the who command: 

$ who 

lori console Jul 26 07:40 

$ 

This shows user iori’ is logged in on the console. 

To show a detailed list of files in the current directory, use the 1$ command with the —1 option: 

$ Is-l 

total 1064 

-rw-r—r— 1 lori 181 Jul 25 17:14 Makefile 
-rw-r—r— 1 lori 460654 Jul 24 17:16 doc .cat 
< etc. > 

-rw-r-r- 1 lori 67 Jul 23 12:31 tabs 
-rw-r—r~ 1 lori 22980 Jul 17 15:42 uucp 
$ 
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The argument tells U to print status information, size and the creation date for each file. 


2 •4*1. Background Commands 

To execute a command, the Shell normally creates a new process and waits for it to finish. You 
may run a command in the background without waiting for it to finish. For example, to put a 
call to the C compiler in the background, you type the ee command line with an ampersand 
at the end of the line: 

$ cc pgin.e & 

321 

$ 

This compiles the file pgm.c. The trailing & is the operator that instructs the Shell not to wait 
for the command to finish. To keep track of a process, the Shell reports its process number, 321 
in this case, following its creation. You can obtain a list of currently active processes using the 
ps (process status) command. 

2«4.2« Input/Output Redirection 

Most commands produce output on the standard output, that is your workstation or terminal. 
You can send this output to a file instead of the standard output by typing, for example: 

$ Is -1 > filedlst 
$ 

The Shell interprets the notation >fileMst and does not pass it as an argument to Is. If file.ltst 
does not exist, the Shell creates it; otherwise the output from Is replaces the original contents of 
filcMst. You can append output to a file with the *> >’ notation: 

$ Is -1 > > file.list 

$ 

A second Is -/ directory contents listing is appended to the first in file.list. In this case file.list is 
also created if it does not already exist. 

A command can take the standard input from a file instead of the workstation by typing the 
*<’ redirection character as in: 

$ we < file.ll8t 

30 234 1540 file.list 

$ 

The command wc reads its standard input, in this case redirected from file.list^ and displays the 
number of characters, words and lines found. If only the number of lines is required, use the —1 
option: 

$ wc -1 < fileJist 
30 file.list 

$ 
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2.4.3. Pipelines and Filters 

Two or more commands connected by the pipe operator form a pipeline, A filter is a com¬ 
mand that reads its standard input, transforms it in some way, and displays the result as out¬ 
put. Pipelines and filters are often used together. 

Use the pipe operator, ‘|’ to connect the standard output of one command to the standard input 
of another. In the example above, the two commands U -I > fUe.list and wc -I < fileJist were 
run to get one desired result. You can run both together; that is, you can process the U output 
with the wc command by typing: 

$ Is -1 I wc 

19 146 963 

$ 

Here, the output of the Is command is piped as input to wc. Two commands connected in this 
way constitute a pipeline^ and the overall effect is the same as: 

$ Is —1 > file.list; wc < file.list 

I 

except that no fUcMst is used. Instead a pipe connects the two processes, which are run in 
parallel. Pipes are unidirectional and synchronization is achieved by halting wc when there is 
nothing to read and halting Is when the pipe is full. 

A filter command transforms its standard input in some way. One such filter, prep, selects from 
its input those lines that contain some specified string. For example, to list those lines, if any, 
from Is that contain the string ‘all’, type: 

$ Is I grep all 

mail.all 

news.all 

refs.all 

shell.all 

summ.all 

$ 

Grep takes the output of Is and searches for the string ‘all’. Another useful filter is sort, which 
orders or ‘sorts’ a file in several different ways. For example, to display an alphabetically sorted 
list of names in the file name.list, type: 

$ sort name.list 

Dan 

Joe 

Mary 

Mike 

Susie 

$ 

Read more about sort in the user’s manual. 

A pipeline may consist of more than two commands. You can pipe Is to grep and then to ipc, 
for example: 
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$ Is I grep all | we -1 
5 

I 

to display the number of filenames in the current directory containing the string ^alF as in the 
example above. 

2.4.4. Filename Expansion ]’ 

As described in the Simple Shell Commands section, the first word of a command is the name of 
the command to be executed. Other words on the command line are arguments to that com¬ 
mands. Many commands accept arguments that are filenames. For example, use the Is com¬ 
mand with the —1 option to display information relating to the file mam.c: 

$ Is -1 mam.c 

-rw-r--^- 1 lori 136783 Jul 26 11:10 main.c 

$ 

The file matn.c is the argument to the Is command. 

The Shell provides a mechanism for generating a list of filenames that match a pattern. For 
example, to generate, as arguments to Is, all filenames in the current directory that end in *.air, 
type; 

$ Is --1 *.aU 

-rw-r>-]v- 1 lori 57022 Jul 23 12:15 mail.all 

-rw-i^-i^ 1 lori 25643 Jul 23 12:15 news.all 

-rw-r-i^ 1 lori 4965 Jul 25 16:50 refs.all 

-rw-r-x^ 1 lori 136783 Jul 26 11:10 shell.all 

-rw-r-r- 1 lori 34121 Jul 25 17:14 summ.all 

$ 

The Shell expands to match any string including the null string, that is, all the files whose 
names end with *.air in the working directory. In general patterns are specified as follows: 

* Matches any string of characters including the null string. 

? Matches any single character. 

[ ] Matches any one of the characters enclosed. A pair of characters separated by a 
minus matches any character lexically between the pair. 

To match all names in the current directory beginning with one of the letters a through r, use: 

I b -1 [&->]* 

mailref: 
total 121 

-rw-r—r~ 1 lori 460654 Jul 24 17:16 doc.cat 

-rw-r—1 lori 292152 Jul 24 16:47 doc.tbl 

< etc. > 

-rw-r—r— 1 lori 58334 Jul 20 17:42 mail.all 

-rw-iv-r- 1 lori 201 Jun 30 23:18 mailO.nr 

I 

The Shell expands the ‘[a-z]*’ argument to all files beginning with any lower-case letter. Be 
careful; this may display a very long list of files. 


Revision D of 7 January 1984 


2-5 





Using the Bourne Shell 


Beginner's Guide 


The character matches all names that consist of a single character in the directory. So you 
can use the 1$ command with on fu9r/frcdlte$t and say: 

$ Is /usr/fred/test/? 

/usr/fred/test/a 
/usr/fred/test/b 

$ 

to match the files a and 6. If no filename is found that matches the pattern, the pattern is 
passed unchanged as an argument, and ‘No match.* is displayed. 

This filename expansion notation saves typing and provides name selection according to some 
pattern. It makes finding a file easy. For example, to find and display the names of all core 
files in subdirectories of / usrffredt say: 

$ echo /u8r/frcd/*/core 

/usr/fred/misc/core /usr/fred/test/core 

$ 

The finds the files core in subdirectories miae and test. As you saw before, echo is a standard 
command that displays its arguments, separated by blanks. This last search feature however, 
can be expensive, requiring a scan of all subdirectories of /fMr//rerf. 

There is one exception to the general rules ^ven for patterns. The character (‘dot’) at the 
start of a filename must be explicitly matched. For instance, using to match any character 
does not match a at the beginning of a filename: 

$ echo ♦ 

Makefile doc.tbl file shell.all uucp 

$ 

Instead, it echos all filenames in the current directory not beginning with even if the current 
directory is your home directory, which contains your .profile file. To match the character at 
the beginning of a filename, type: 

$ echo • * 

$ 

This echos all those filenames that begin with including the names and which mean 
‘the current directory’ and ‘the parent directory’ respectively. 

See the Shelt Metacharacter Summary section for a quick reference list of the metacharacters. 

2.4.5. Quoting the Metacharacters with * and ‘ 

Characters that have a special meaning to the Shell, such as * < >’, *♦’, ‘?’ | *&’, are called 
metacharacters. Any character preceded by a * \’ is quoted or escaped and loses its special 
meaning, if any. The ‘ \’ is called the escape character and elided so that to echo a single ‘?’, 
type: 

$ echo \? 

? 

% 

And to echo a single ‘<’, type: 
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$ echo \< 

< 

I 

The * \’ prevents the Shell from using the special meanings of and ^<\ 

To continue long commands over more than one line, the sequence \newline is ignored. 

The ^ is cdnyenient for quoting single characters, but when more than one character needs 
quoting, it is clumsy and error prone. Enclose the string of characters between single quotes. 
For example, to quote a series of four asterisks so that they lose their special matching capabib 
ity, type: 

$ echo xx’*****xx 
xx****xx 

I 

The quoted string may not contain a single quote, but may contain newlines, which are 
preserved. This quoting mechanism is the most simple and is recommended for casual use. 

A third quoting mechanism using double quotes prevents interpretation of some but not all 
metacharacters. 


2.5. ProgFamming the Shell 

Use the Shell to read and execute commands contained in a file. A file containing commands is 
called a command procedure or Shell procedure. 

A simple Shell procedure uses the echo command: 

$ cat > welcome 
echo Good morning! 

D 

$ 

To call the Shell to read commands from welcome^ use the oh command: 

I fh welcome 
Good morning! 

I 

In general, this format looks like: 

I ah file I arg$ ... ] 
in which $h calls commands from file. 

You can either execute a Shell procedure with oh or make the procedure executable. The chmod 
(change mode) command can make a file readable, writable and executable. 

For example, to make welcome executable, type: 

$ chmod +x welcome 

Following this, the command: 

I welcome 
Good morning! 

$ 
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is equivalent to: 

$ sh welcome 

Good morning! 

$ 



You can also use the chmod command in the following format: 

$ chmod 755 welcome 
$ welcome 

Good morning! 

$ 

which has the same effect as the first. See the user’s manual for details on the chmod command. 

An executable command is noted with an asterisk in an h -F directory listing. So if you 
were to list the directory contents now, it would show among other things: 

$ Is -F 

< etc. > 
welcome* 

$ 


The Shell also has the capability to define a named variable and assign a value to it. The sim¬ 
plest way to set a Shell variable is to use an assignment statement 

variable—value 

You can then use the assigned value by preceding the name of the variable with a dollar sign: 
$variable 

Now make a file called bliss which contains the assignment statements: 

food=bread 
drink=wine 
person=thou 

echo $food, $drink, Iperson ....Ah! 

Make bliss executable with chmod, and execute it: 

$ chmod 755 bliss 
$ bliss 

bread, wine, thou ....Ah! 

$ 



As another example, make a string-searching file called Isg (for is-grep’) that contains: 

Is I grep $1 

Make it executable with chmod and use it to find filenames containing the string ^all’ in the 
current directory: 
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I chmod 755 kg 
Ikg’alP 

allnames 

allx 

maiLall 

$ 

You can thus use Shell procedures and programs interchangeably. 

As well as proyiding names for the positional parameters, the number of positional parameters 
in the call is available as $#. You can refer to the name of the file being executed as $0 • 

There are some predefined Shell variables, some of which are modifiable and some of which are 
read-only. You have already seen: 

HOME — Set to the user’s home directory. 

PATH — Set of directories that the Shell searches in order to find commands. 

PSl — Primary prompt string, here the *$’. 

You can also set a Shell variable from the output of a command. For example: 

I nows=‘date* 

I echo $now 

Fri Aug 12 08:23:12 PST 1983 

$ 

Note that the characters surrounding the command are grave accents, not apostrophes. 

To set a Shell variable equal to a value contained in a file, use: 
todo—‘cat plan* 

This calls the cat command with the argument plan, where the plan file contains: 

Eat breakfast. 

Go to work. 

The resulting value of ‘Itodo’ is: 

$ echo $todo 

Eat breakfast. Go to work. 

I 

A different type of Shell variable is one which is passed to the Shell procedures when it is called. 
These arguments called positional parameters and are referred to by number, $1, $2, ... Con¬ 
sider the following simple Shell procedure: 

I cat > reverse 
echo $6 15 $4 $3 $2 tl 
D 

$ chmod 755 reverse 
$ reverse do re mi fa so la 
la so fa mi re do 

$ 

You can also use the flow control programming constructs if,, else^ while., doy and others to con¬ 
trol the action taken by the procedure. See the Programming Tools for the Sun Workstation for 
more information on programming the Shell. 
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2.6. Shell Metacharacter Summary 

o 

Table 2*1: Syntactic Metacharacters 


I pipe symbol 

; command separator 

& background commands 

( ) command grouping 

< input redirection 

> output creation 

Table 2-2: Filename Expansion Metacharacters 

• match any character(9) including none 

? match any single character 

[...] match any of the enclosed characters 


Table 2-3: Substitution Metacharacters 

${...} substitute Shell variable 

substitute command output 

Table 2-4: Quoting Metacharacters 

\ quote the next character 

quote the enclosed characters except for 
”...” quote the enclosed characters except for I ' \ ” 


o 
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Chapter 3 


Mail User s Guide 


The Mail User^s Guidc^ describes how to use the mail program to send and receive messages. It 
also provides summary information and quick reference pages at the end for easy use. It 
assumes you are familiar with the C*Shell, a text editor like vi or exy and some of the common 
Sun system commands. If you are not, read the Introduction to the Sun System in Part One of 
this manual. For additional details on Sun system commands, consult the User *s Manual for the 
Sun Workstation» Set-up information for the mail facility is in the System Manager's Manual 
for the Sun Workstation . 

Mail provides a communication facility for sending and receiving mail among users on the same 
host, users on different hosts linked to your local network, and users linked to the ARPANET, 
UUCP, and Berkeley networks. You use a set of editing commands to manipulate messages, and 
to define and send mail to names which label user groups. 

Briefly, here is how mail handles messages: mail divides incoming mail into its constituent mes¬ 
sages so you can deal with them in any order you please. The mail system collects the messages 
for you from other people in a file, called your system mailbox. When you login, the system 
notifies you if there are any messages waiting in this system mailbox. When you read your mail 
using mailf it reads your system mailbox and separates that file into the individual messages 
that have been sent to you. You can then read, reply to, delete, or save these messages. Each 
message is marked with its author, the date sent, and the message subject among other things. 


3.I. Sending Mail 

The mail command has three ways to send mail, depending on where your recipient has a login 
account. If he has a host machine linked to your local network, use the method described in 
Sending Mail on the Local Network. If he has a login account on the same host as yours, use the 
method described in Sending Mail on the Same Host. If your recipient logs in on a machine con¬ 
nected to yours by UUCP, use the method described in Sending Mail on the Network. 


Sending Mail on the Local Network 

To send mail to users on other hosts linked to yours on the local network, use the mail com¬ 
mand followed by the login name and the host machine name of your recipient; for example, 
type: 


^ The material in this guide is derived from the Mail Reference Manual, Kurt Shoens, Craig 
Leres. 
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tutorial^ mail joeOvenua 

Is the meeting planned for this afternoon? 

D 

EOT 

tutorial^ 

This sends mail to ‘joe’, which is the login name of the person you’re sending mail to. Joe’s 
hostname is ‘venus’, which is where he has an account and logs in. End your message with a "D 
(an EOT) at the beginning of a line. Mail echoes EOT and returns you to the Shell. 

The message ‘joe’ reads consists of the message you typed, preceded by several header lines tel¬ 
ling who sent the message (your login name), the date and time it was sent, and various other 
details. 

If, while you are composing the message you decide that you do not wish to send it after all, 
you can abort the letter with your current interrupt character (the default is *C). Typing a sin¬ 
gle INTERRUPT causes mail to display: 

(Interrupt — one more to kill letter) 

Typing a second INTERRUPT saves your partial letter in the file deadJetter in your home direc¬ 
tory and aborts the letter. Once you have sent mail to someone, there is no way to undo the 
act, so be careful. 

3.1.2. Sending Mail on the Same Host 

Sending mail to a plain login name without a hostname sends mail to that person assuming he 
has an account on your machine. To send a message to ‘roger’, who has a login account on 
your host, type: 

tutorial^ mail roger 

Let’s play tennis this afternoon. 

D 

EOT 

tutorial^ 

End your message with a "D (an EOT) at the beginning of a line as before. Mail echoes EOT 
and returns you to the Shell. Later, the user ‘roger’ to whom you sent mail receives the mes¬ 
sage: 

You have mail. 


or 

You have new mail, 
or 

New mail has arrived, 
to tell him he has a message waiting. 

If you want to send the same message to several other people, you can list their login names on 
the command line. For instance: 
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tutorial^ mail john marty david 
Meeting at three o’clock. 

Please be on time. 

EOT 

tutorial% 

sends the reminder to John, Marty, and David. 

3.1.3. Sending Mail on the Network 

If your recipient logs in on a machine connected to yours by the telephone line network called 
titfcp (unix to Unix copy), you must know the list of machines through which your message must 
travel to arrive at his site. So, if his machine is directly connected to yours, you can send mail 
to him using his hostname, the *!' or ^bang* character, and his login name. If you are using the 
O^Shell as our example shows, you must also escape the special character with a backslash ‘ 
\\ For example: 

tutorial% mail venu8\!joe 

sends mail to the user ‘joe’ whose uucp hostname is ‘venus’. The general syntax is: 
tutorial^ mall ho$tname\lname 

If your message must go through an intermediate system first, use the syntax: 

tutorial^ mail intermediate\\ho9tname\lusername 

Ask your system administrator about a ‘map’ of all the systems in the network connected to 
your site. 

There are several advanced facilities to learn about in the section Sending Mail with Tilde 
Eicapei. 

3.2. Reading Your Mail 

If, when you log in, you see the message: 

Last login: Tue Aug 6 13:42:21 on console 

Sun UNIX 4.2 (Berkeley beta release) (GENERIC) #8: Oct 23 13:45:52 PDT 1983 

You have mail. 

tutorial% 

you can read the mail by typing simply: 
tutorial^ mail 

Mail responds by displaying its version number and date and then listing the messages you have 
waiting. Then it prompts you and waits for your command. The messages are assigned 
numbers starting with 1, so you refer to the messages with these numbers. Consider the follow* 
ing: 
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Mail version 2.17 12/26/82. Type t for help. 

“/usr/spool/lori”: 2 messages 2 new 

>N1 Steve Wed Sep 21 09:21 12/277 "Weekly Meeting” 

N 2 wendy Tue Sep 20 22:55 

Mail keeps track of which messages are ‘new*, that is, have been sent since you last read your 
mail, and which messages are ‘read’, that is, that you have read. New messages have an N next 
to them in the header listing and old, but unread messages have a U next to them. Mail keeps 
track of new/old and read/unread messages by putting a header field called ‘Status’ into your 
messages. 

To look at a specific message, use the print command, which may be abbreviated to simply p. 
You can examine the first message above by typing: 

& print 1 
Message 1: 

From Steve Tue Aug 2 10:28:33 1983 
Date: 2 Aug 83 10:28:27 PDT (Tue) 

From: steve (Steve Smith) 

Subject: Weekly Meeting 

Message-Id: < 8308021728.AA05502@sun.uucp > 

Received: by sun.uucp (3.320/3.14) 

id AA05502; 2 Aug 83 10:28:27 PDT (Tue) 

To: henry 
Status: R 

Meeting at three o’clock. 

Please be on time. 

& 

Many mail commands that operate on messages take a message number as an argument like the 
print command. These commands have a notion of a current message. When you enter the 
mail program, the current message is initially the first new message. Thus, you can often omit 
the message number and use simple p to display the current message: 

& p 

Another shorthand method is to display a message by simply giving its message number. To 
display the first new message, say: 

& 1 

Frequently, it is useful to read the messages in your mailbox in order, one after another. You 
can read the next message in mail by simply typing a newline. As a special case, you can type a 
newline as your first command to mail to type the first unread message. 


3,3. Replying to Mail 

If you wish to send a reply immediately after reading a message, you can do so with either the 
rcp/y or the Reply command. There is a distinct difference between the two commands. 

Sometimes you will receive a message that has been sent to several people and wish to reply 
only to the person who sent it. In this case, use a simple lowercase r to reply to the sender only. 
A reply, like type, takes a message number as an argument. To reply to the sender and to 
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every one who received the original message, use the command. Type in your reply, fol¬ 

lowed by a at the beginning of a line, as before. Mail displays EOT and the ampersand 
prompt to indicate its readiness to accept another command. 

In our example, if you wish to reply to the first message after reading it, use the command: 

& Reply 
To: Steve 

Subject: Re: Weekly Meeting 

and enter your letter. You are now in the message collection mode, and mail gathers up your 
message up to a *D. Note that it copies the header from the original message to make it easy 
to recognize. If there are other header fields in the message, that information will also be used. 
For example, if your letter has a ‘To:* header listing several recipients, mail sends your reply to 
those same people as well. Similarly, if the original message contained a ‘Cc:* (carbon copies to) 
field, your reply goes to those users, too. Mail is careful, though, not to send the message to 
you, even if you appear in the ‘To:* or ‘Cc:* field, unless you ask to be included explicitly. More 
on this later. 

When you use the Reply command to respond to a letter, there is a problem of figuring out the 
names of the users in the ‘To:* and ‘Cc:* lists ‘relative to the current machine.* If the original 
letter was sent to you by someone on the local machine, then this problem does not exist, but if 
the message came from a remote machine, the problem must be dealt with. Mail uses a heuris¬ 
tic to build the correct name for each user relative to the local machine. So, when you reply to 
remote mail, the names in the ‘To:* and ‘Cc:* lists may change somewhat. After typing in your 
letter, your correspondence looks like: 

& Reply 

To: Steve 

Subject: Weekly Meeting 

Thanks for the reminder 
D 

EOT 

& 

The Reply command is especially useful for sustaining extended conversations over the message 
system, with other ‘listening* users receiving copies of the conversation. Abbreviate the Reply 
command to R once you get the hang of things. 

Use replysender to respond to the sender only and use replyall to respond to everyone who 
received the message regardless of how the replyall option is set in your ,mailrc file. In other 
words, replyall and replysender override all other settings. The replyall option is different than 
the replyall command; see Setting Your Options with *seV for a description of the replyall 
option. 

If you wish, while reading your mail, to send a message to someone, but not as a reply to one of 
your messages, send the message directly with the mail command, which takes as arguments the 
names of the recipients you wish to send to. For example, to send a message to Wendy, type: 

& mall wendy 

Your presentation yesterday was very informative. 

EOT 

& 
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Normally, each message you read is saved in your mailbox or mboi file in your login directory at 
the time you leave matl Often, however, you will not want to save a particular message you 
have received because it is only of passing interest. To avoid saving a message in mboXf delete it 
by typing: 

& delete 1 

This makes message 1 from Steve disappear altogether, along with its number. Abbreviate the 
delete command to d, 

3.4. Customizing Your Mail 

There are several ways to customize the mail facility. If you have accounts on several systems 
and want to direct your mail to a single account, you need a forward file in the home direc< 
tories of those other accounts. You can also use the $et and aliaa commands to tailor many mail 
features to your personal uses. 


3.4.1. Forwarding Your Mail from Other Accounts 

If there is a large number of systems at your site or if you are linked to USENET, you may have 
accounts on several machines. To forward your mail to a single account where mail will notify 
you that you have mail, create a .forward file in the home directories of all the accounts from 
which you want mail forwarded. For example, you may have an account on Venus’ where other 
users sometimes send you mail, but you usually log in to your account on ^tutorial’. Create a 
.forward file on your account on Venus’ and add: 

sam^tutorial 

substituting your login name for ‘sam.’ Mail sent to your account on Venus’ will then be foiv 
warded to your account on ‘tutorial’. 

Another way of forwarding mail is to use aliases. See Streamlining Your Mail with Wias’for 
details. 


3.4.2. Setting Your Options with ‘set’ 

Set has two forms, one for setting a binary option and one for setting a valued option. Binary 
options are either on or off, while valued options let you select from several choices. For exam¬ 
ple, you can choose which editor to use by setting the EDITOR option. You can use these 
options after entering mail or you can set them permanently by putting the appropriate line in 
your .login or .mailrc file. To use them from mail, you type: 

& set option 

To include them in your .login or .mailre file, edit the file to include the line: 
set option 

A complete list of matV options appears in Additional Features. 

As a C-Shell (csh) user, you will be notified when new mail arrives if you inform the C-Shell of 
the location of your system mailbox in the directory jutr!epooljmail in a file with your login 
name. If your login name is ‘karen’, you can make ah notify you of new mail by including the 
following line in your .login file in your home directory: 


3-6 


Revision C of 7 January 1984 




Beginner 8 Guide 


Mail User s Guide 


set mailss/usr/spool/inail/karen 

Another useful option is atkf which informs mail that you want to be prompted for a subject 
header to be included in the message. To set the ask option in mat’/, type: 

& set ask 

To set this option permanently, put the line set ask in your ,mailrc file in your home directory. 

Set the reply all option if you want reply to respond to everyone who received a message and 
Reply to respond to the sender only. In a sense, the replyall option reverses the meanings of the 
reply and Reply commands. Again, you can use 

Another useful option is hold, which tells mail to keep your messages in the system mailbox 
instead of moving them to your mbox file in your home directory as it normally does when you 
leave mail 

Use valued options to adapt mail to your personal use. For example, the SHELL option tells 
which Shell you like to use, and is specified by: 

& set SHELLas/bin/sh 

Note that no spaces are allowed in *SHELL«/bin/sh.* A default Shell is used if none is 
specified. 

Another important valued option is crt, which prevents long messages from flying by too quickly 
for you to read them. Setting the crt option sends any message longer than a given number of 
lines through the paging program more. Try setting this option for your workstation as: 

& set crt=34 

(or 24 if you are using a terminal) to paginate messages that will not fit on your screen. More 
displays a screenful! of information, then shows —MORE—. Type a space to see the next screen- 
full or RETURN to see the next line. It is not necessary to type in these set commands each time 
you run mail See the discussion of .mailrc in Streamlining Your Mail with *alias \ 

3.4.3. Streamlining Your Mail with ^alias’ 

Mail has an alias adaptation, similar to the C-Shell. An alias is simply a name which stands for 
one or more real user names. When you send mail to an alias, you are really sending it to the 
list of real users associated with it. For example, define an alias for the members of a project, 
so that you can send mail to the whole project by sending mail to just a single name. Suppose 
that the users in a project are named Dan, Rick, Tom, and John. Define an alias ‘project* for 
their project group by typing: 

& alias project dan rick tom John 

You can then send mail to all of them by typing: 

& mail project 
< etc. > 

D 

EOT 

tutorial^ 

Use alias to provide a convenient name for someone whose user name is inconvenient. For 
example, if a user named Margaret Cunningham has the login name ‘margaret*, you can set an 
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alias with: 

& alias mar margarei 

so that you can send mail to the shorter name, ‘mar\ 

The alias and set commands let you customise mat/, but you wouldn’t want to have to retype 
them each time you enter mail To make them more convenient to use, put the set options and 
aliases you want in your .mailrc file in your home directory. For example, a ,mailrc file can 
look like: 

set ask nosave crt=24 SHELL =*/bin/csh 
alias project dan rick tom John 

What happens here is that mai7 always looks for two files when it is invoked. It first reads a 
system-wide file /««r//i6/A/ai7.rc, then your user-specific file, .mailrc in your home directory. 
The system administrator at your site maintains the system-wide file, which contains set com¬ 
mands that are applicable to all users of the system. 

The mail delivery system sendmail provides a system-wide aliases file called jusrllib/aliases 
which provides a more efficient way to keep a large database of mail aliases. For details, refer 
to the Sendmail Installation and Operation Guide in the System Manager's Manual for the Sun 
Workstation. 


3.5. More on Reading Mail 

You have seen that you can invoke mail with command line arguments that name people to 
send the message to, or with no arguments to read mail. Specifying the —f flag on the command 
line causes mail to read messages from a file other than your system mailbox. For example, if 
you have a collection of messages in the file letters^ use mfli7 to read them with: 

tutorial^ mail -f letters 

“letters”: 3 messages 

& n 

-♦1 lori Tue Jul 26 14:55 11/102 “Company Party” 

<etc.> 

& 1 

From lori Tue Jul 26 14:55:09 1983 
Date: 26 Jul 83 14:55:04 PDT (Tue) 

From: lori (Lori Rosen) 

Subject: Company Party 

Message-Id: <8307262155.AA04140@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA04140; 26 Jul 83 14:55:04 PDT (Tue) 

To: Steve 
Status: R 

Please make plans for the company 
party in October. 

& 

You can use all the mail commands described in this manual to examine, modify, or delete mes¬ 
sages from your letters file, which is rewritten when you leave mail with the quit command 
described below. 
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Since mail that you read is saved in the file mbox in your home directory by default, you can 
read it by using simply: 

tutorial^ mail -f 
“/^r/lori/nibox’^ 7 messages 
& 

Normally, messages that you examine using the print command are saved in the mboz file in 
your home directory if you leave mail with the quit command described below. If you wish to 
retain a message in your system mailbox you can use the praerve command to tell mail to leave 
it there. Preserve accepts a list of message numbers, just like print and may be abbreviated to 
prc. 

Messages in your system mailbox that you do not examine are normally retained in your system 
mailbox automatically. If you wish to have such a message saved in mboz without reading it, 
use the mboz command to save it. For instance: 

& mbox 2 
& quit 

Saved 1 message in mbox 

Held 1 message in /usr/spool/mail/lori 

tutorial^ 

saves the second message in mboz when you give the quit command. The mboz command is also 
the way to direct messages to your mboz file if you have set the hold option described above. 
You can abbreviate mboz to mb, 

3.6. Printing a Mail Message 

To print a message, save the message in a file, and then send it to your printer: 

tezt of mail 
& • good.letter 

"/usr/evan/good.letter” (New file} 37/1530 
q 

tutorial^ pr good.letter | Ipp -Pprinter 
tutorial^ 


3.7. Quitting Mail 

When you have read all the interesting messages, you can finish the mail session with the quit 
command. Quit does different things with the messages depending on whether you read a mes¬ 
sage, skipped over it, or deleted it: 

• Messages that you read but didn’t delete are appended to mboz in your home directory. 

• Messages which you simply skipped over and didn’t delete are kept in the system mail¬ 
box so you can read them the next time you use mail. 

• Deleted messages are gone forever. 

Note that you can retrieve deleted messages with the ti (undelete) command as long as you are 
still in mail. Once you quit the mail program however, deleted messages are irretrievable. 
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To quit ffifli/, type: 

& quit 

Saved 1 message in mbox 

Held 1 message in /usr/spool/mail/lori 

tutorial^ 

You can abbreviate the quit command to q. 

If you wish for some reason to leave mail quickly without altering either your system mailbox or 
mboxy type: 

& X 

tutorial^ 

(short for exit) which immediately returns you to the Shell without changing anything. 

If, instead, you want to execute a Shell command without leaving mailt command pre> 

ceded by an exclamation point, just as in the text editor. For instance: 

& Idate 

Tue Jul 26 12:32:12 PDT 1983 

! 

& 

displays the current date without leaving mail. 


3.8. Mail Help —‘r 


Type a question mark 

to get a brief summary of the mail command abbreviations: 

&? 

c < directory > 

chdir to directory or home if none given 

d < message list> 

delete messages 

e < message list> 

edit messages 

f < message list> 

show from lines of messages 

h 

print out active message headers 

m <user list> 

mail to specific users 

n 

goto and type next message 

p < message list> 

print messages 

pre < message list> 

make message go back to system mailbox 

q 

quit, saving unresolved messages in mbox 

r < message list> 

reply to sender only of messages 

R < message list> 

reply to messages 

s <messagel Iist> file 

append messages to file 

t < message list> 

type messages (same as print) 

top < message Iist> 

show top lines of messages 

u < message list> 

undelete messages 

w < message list> file 

append messages to file, without from line 

X 

quit, do not change system mailbox 

f 

shell escape 


A <message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted. Mail uses the last message typed. 
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3.9« Collecting Groups of Messages in Folders 

MdiV includes a simple facility for maintaining groups of messages together in folders. 

To use the folder facility^ put a line like: 
set folders=sletters 

in your .mailrc file to indicate where your folder directory should be kept. Each folder of mes¬ 
sages is a single file^ and all of your folders are kept in that directory. If, as in the example 
above, your folder directory does not begin with a 7/ assumes that your folder directory is 
to be found starting from your home directory. Thus, if your home directory is Iu$rlperson the 
above example puts your folder directory in /usrlpersonHetters. 

Anywhere a filename is expected, you can use a folder name, preceded with \ For example, 
to put a message into a folder with the save command, use: 

& save -f records 

“/tisr/iisername/lctters/records’’ [New file] 13/272 

& 

This saves the current message in the records folder. If the records folder does not yet exist, it 
is created. Note that messages which are saved with the save command are automatically 
removed from your system mailbox. 

To copy a message into a folder without removing it from your system mailbox, type: 

& copy d-records 

“/^r/uscrnamc/letters/records” [Appended] 11/282 

& 

This copies the current message into the records folder and leaves a copy in your system mail¬ 
box. The ^appended^ message indicates that you already have a message in the records folder. 
Copy is identical in all other respects to save. 

Use the folder command to read the contents of a different folder. For example: 

& folder +records 

causes mail to close the file it is currently reading (as if you had typed q) and direct its atten¬ 
tion to the contents of the records folder. All of the commands that you can use on your sys¬ 
tem mailbox are also applicable to folders, including printy deletCy and reply. To inquire which 
folder you are currently editing, use simply: 

& folder 

To list your current set of folders, use the folders command: 

& folders 

If you want to start reading one of your folders, use the ^f option described previously. For 
example: 

tutorial^ mail -f -f records 

reads your records folder without looking at your system mailbox. 
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3.10* Sending Mail with Tilde Escapes 

While typing in a message to be sent to others, it is often useful to be able to inyoke the text 
editor on the partial message, display the message, execute a Shell command, or do some other 
auxiliary function. Mail provides these capabilities through ‘tilde escapes,* which consist of a 
tilde ‘"’at the beginning of a line, followed by a single character which indicates the function to 
be performed. 


3.10.1. Displaying the Message Text with ‘~p* 

If you are typing in a long message and want to to display the text of the message so far, use 
the ‘"p’ escape: 

tutorial^ mail lori 
A very long message ... 

P 

Message contains: 

To: lori 

Subject: Company Party 
A very long message ... 

(continue) 

The ‘~p’ displays a line of dashes, the recipients of your message, and the text of the message so 
far. Since mail requires two consecutive "C’s (RUBOUTs, INTERRUPTS, DELETEs) to abort a 
letter, you can use a single X to abort the output of *"p’ or any other escape without killing 
your letter. 


3.10.2. Editing a Message — *~e’ and 

If you are dissatisfied with the message as it stands, you can use a text editor on it. To use the 
default line editor eXj type: 

"e 

The ‘~e’ escape copies the message into a temporary file for editing. After modifying the mes¬ 
sage to your satisfaction, write it out and quit the editor. Your screen displays: 

(continue) 

after which you may continue typing text which will be appended to your message, or type "D 
at end the message. Mail provides a standard text editor, but you can override this default by 
setting the valued option ‘EDITOR’ to something else. For example, you might prefer to use the 
VI display editor from Berkeley instead of the ex editor. Edit your .login file to contain: 

setenv EDITOR /usr/ueb/vi 

Mail also defines a default visual display editor, vi. To use vi for editing your current message, 
use the escape: 

~v 

The ‘~v’ escape works like ‘"e’, but invokes the visual rather than the text editor. If it does not 
suit you, you can set the valued option ‘VISUAL’ to the pathname of a different editor. 
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3.t0.3. Including a File in Yaur Mdttiage with 

If you want to read ihO contents of some fils into your message, tlie esca^ *V appends the 
named file: 

~r datafilo 

“datafile” 14/512 

In this case, datafile \s added to your current message. If the read is successful, the number of 
lines and characters appended to your messaj^ is printed^ after which you may continue 
appending text. A/stif complains if the file doesn^t exist or canH be read; for example: 

tutorial% mail k>ri 
Subject: Company Party 
~r budget 

budget: No such file or directory. 

The filename may contain Shell metacharacters like and which are expanded according to 
the couTentions of your Shell. 


3.10.4* Using the MeadJetter’ File with ‘"d’ 

Similar to the *^r' escape b the *''d* escape which reads the file dead,letter in your home direc* 
tory. For instance: 

d 

“/usr/Iori/dead.letter” 2/24 

reads in deadJetter to your current message. You can use ^'d* to recycle a message you aborted 
with ^C, since mail copies the text of aborted messages into deadJetter, 

3.10.5. Saving Message Text in a File with *^w’ 

To save the current text of your message in a file, use the ^''w* escape: 

"w iVtficrarp 
“itinerary”: 7/180 

Mail displays the number of lines and characters written to the file, after which you may con¬ 
tinue appending text to your message. You can use Shell metacharacters in the filename, as 
with 

3.10.6. Forwarding a Message with ‘~m’ and ‘~f* 

It you are sending mml from within maiTs command mode, you can read a message sent to you 
into the message you are writing with the escape: 

& mail lori 

Subject: Company Party 
& "m 4 
Interpolating: 4 
(continue) 
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which reads message 4 into the current message, shifted right by one tab stop. You can name 
any non-deleted message, or list of messages. 

You can also forward messages without having them indented by a tab stop in the text with the 
‘~r escape. 

& mail lori 

Subject: Company Party 

& f 4 

Interpolating: 4 
(continue) 


3.10.7. Adding People to the Message List with ‘~t* 

If, in the process of composing a message, you decide to add additional people to the list of mes¬ 
sage recipients, you can do so with the escape: 

~t name! nomt2 ... 

You may name as few or many additional recipients as you wish. Note that the users originally 
on the recipient list will still receive the message; you cannot remove someone from the recipient 
list with ‘“t’. 

3.10.8. Adding a Message Subject with 

If you wish, you can pick a subject for your message or change the one you oripnally chose if 
you have the atk option set, by using the ‘~s’ escape: 

"m New Message Subject 

The ‘"s’ replaces any previous subject with ‘New Message Subject.* The subject, if given, b 
placed in the ‘Subject* heading near the top of the message. It*s a good idea to use the ‘~p* 
escape to see what the message will look like if you make a lot of changes which are not 
immediately displayed as you type in text. 

3.10.9. Sending Copies with and 

If you want to ‘copy’ people on a message, use the ‘"c* escape: 

“c name! nameS 

The ‘~c’ escape adds the named people to the ‘Cc:* list. 

To add blind copy recipients to a message, that is, people who will receive a copy of your mes¬ 
sage but whose names will not be listed on the message, use the ‘"b* escape: 

"b name 1 nameS ... 

Again, use ‘~p’ to see what the message will look like. 
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tutorial^ mail lori 
Subject: Company Party 
Uzt 

"c joe dan 
~b shelley 
P 

Message contains: 

To: lori 

Subject: Company Party 
Cc: joe dan 
Bcc: shelley 

text 

(continue) 


3.10.10. Editing the Header Fields with ^~h^ 

The recipients of the message together constitute the *To:’ field, the subject the ^Subject*/ field, 
and the carbon copies the ^Cc:* field. If you wish to edit these fields in ways impossible with the 
‘~s’, and escapes, you can use the ‘~h’ escape, which displays each of the fields in turn: 

To: lori 

Subject: Company Party 
Cc: 

Bcc: 

(continue) 

The ‘~h’ escape first displays ‘To:’ followed by the current list of recipients and leaves the cur¬ 
sor at the end of the line. Typing in ordinary characters appends them to the end of the 
current list of recipients. You can also use your erase character DEL to erase back into the list 
of recipients, or your kill character "U to erase them altogether. Typing a newline, advances to 
the ‘Subject’ field, where the same rules apply. Another newline brings you to the ‘Cc:’ field, 
and so on. Another newline leaves you appending text to the end of your message. You can 
use ‘^p’ to display the current text of the header fields and the body of the message. 


3.10.11. Escaping to the Shell with ^ 

To escape to the Shell temporarily to execute a command, use the *“!’ escape: 

"Ipwd 

/usr/lori /tutorial 

! 

You can use a Shell command and return to mailing mode without altering the text of your 
message. If you wish, instead, to filter your message through a Shell command, you can use the 
‘"I’ escape: 
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‘'\command 

(continue) 

which pipes your message through the command and uses the output as the new text of your 
message. If the command does not produce any output, mail assumes that something is amiss 
and retains the old version of your message. A frequently-used filter is the command /mf, which 
justifies the message text. For example, you can type a message like the following and run it 
through fmt: 

tutorial^ mail steve 
Subject: Company Party 

Please make plans for the company party in October. 

We have a 

lot of scheduling and budgeting to do. 

I will be on vacation 
for three weeks in September, 
so we should firm up 
the plans before I leave. 

~lfmt 

(continue) 

D 

EOT 

tutorial^ 

to send your recipient ‘steve’ the formatted version: 

From lori Fri Aug 5 16:18:02 1983 
Date: 5 Aug 83 16:17:55 PDT (Fri) 

From: lori (Lori Rosen) 

Subject: Company Party 

Message-Id: <8308052317.AA00232@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA00232; 5 Aug 83 16:17:55 PDT (Fri) 

To: steve 
Status: R 

Please make plans for the company party in October. We have a lot 
of scheduling and budgeting to do. 1 will be on vacation for three 
weeks in September, so we should firm up the plans before I leave. 


3.10.12. Escaping to ‘mail’ Command Mode with 

To escape to mail command mode temporarily, use the escape: 

~imaH command 

This is especially useful for reshowing the message you arc replying to by using for example: 
~:t 

It is also useful for setting options and modifying aliases. 
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3.10.13. Changing the Tilde Escape and Using a Tilde as a Tilde 

If you want or need to cbange the escape character to something other than the tilde use the 
^escape* option. For instance: 

set escapes] 

lets you use a right bracket instead of a tilde. Changing the escape character removes the spe¬ 
cial meaning of the tilde *^ 

If you wish for some reason to send a message that contains a line beginning with a tilde, you 
must double it. Thus, for example: 

~This line begins with a tilde. 

sends the line: 

~Thi8 line begins with a tilde. 

If you ever need to send a line beginning with your new escape character, such as the right 
bracket as suggested above, double it, just as for 

3*10.14. If You Need Help — 

If you forget which tilde escape does what and need a quick reminder while you are sending 
someone a message, type the escape: 

The ‘"T’ displays a brief summary of the available tilde escapes. 


3.11. Special Recipients 

As described previously, you can send mail to either user names or alias names. Special conven¬ 
tions provide the capability of sending messages directly to files or to programs. If a recipient 
name has a ‘/’ *1' or begins with a ‘+ ’, it is assumed to be the pathname of a file to which to 

send the message. If the file already exists, the message is appended to the end of the file. If 
you want to name a file in your current directory (that is, one for which a */’ would not usually 
be needed) you can precede the name with *./\ So, to send mail to the file memo in the current 
directory, type: 

tutorial^ mail ./memo 

If the name begins with a *+ it is expanded into the full pathname of the folder name in your 
folder directory. Sending mail to files can be used for a variety of purposes, such as maintaining 
a journal and keeping a record of mail sent to a certain group of users. You can keep a record 
automatically by including the full pathname of the record file in the n/tos command for the 
group. Using our previous alias example, you can say: 

alias project dan rick tom John /usr/project/mailjrecord 

Then, all mail sent to ^project* is saved in the file /uarjprojectjmailjrecord as well as being sent 
to the members of the project. You can examine this file using mail -f. 

When you need to send mail directly to a program, preface the program name with a Mail 
treats recipient names that begin with a as a program to send the mail to. For example, you 
might write a project billboard program and want to access it using mail. To send messages to 
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the billboard program, send mail to the special name billboard*. You can set up an alias to 
refer to a ‘|* prefaced name if desired. 

Caveatt: Because the Shell treats specially, you must quote the program* on the command 
line to present it as a single argument to mail. Surround the entire name with quotes. This also 
applies to use with the alia* command. For example, if you want to alias 7usr/local/bugfiler* 
to ‘bugfiler’, say: 

alias bugfiler ’| /usr/local/bugfiler* 


3.12. Additional Features 

This section describes some additional commands for handling lists of messages, receiving your 
mail, and setting options. 


3.12.1. Message Lists 

Several mail commands accept a message list as an argument. Along with type and delete^ 
described above, there is the from command, which displays the message headers associated 
with the message list passed to it. Use from in conjunction with some of the message list 
features described below. 

A message list consists of a list of message numbers, ranges, and names, separated by spaces or 
tabs. Message numbers may be either decimal numbers, which directly specify messages, or one 
of the special characters ‘"*, or ‘$* to specify the first relevant, current, or last relevant mes¬ 
sage, respectively. ‘Relevant* means ‘not deleted* for most commands, and ‘deleted’ for the 
undelete command. 

A range of messages consists of two message numbers separated by a hyphen. So, to display the 
first four messages, use: 

& type 1-4 

and to display all the messages from the current message to the last message, use: 

& type .-$ 

A name is a user name. The user names given in the message list are collected, and each mes¬ 
sage selected by other means is checked to make sure that one of the named users sent it. If the 
message consists entirely of user names, then every message that is relevant and sent by one of 
those users is selected. Thus, to display every message that peter sent to you, type: 

& type peter 

As a shorthand notation, you can specify simply ‘** to get every ‘relevant* (same sense) message. 
So to display all undeleted messages, type: 

& type ♦ 

To delete all undeleted messages, type: 

& delete • 

And to undelete all deleted messages, type: 

& undelete * 
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You can search for the presence of a word in subject lines with */*. For example, to display the 
headers of all messages that contain the word 'PASCAL*, say: 

& from /pascal 

Note that subject searching ignores upper/lower case differences. 


3.12.2. List of Commands for Receiving Mail 

This section describes all the matY commands ayailable when receiving mail. 

& tcommand 

Escape to the Shell to process commantL 

fe - Go to the previous message and display it. 

& ? Display a brief help summary about mail commands. Same as kelp, 

alias Define a name to stand for a set of other names. Use this when you want to send 

messages to a certain group of people and want to avoid retyping their names. For 
example: 

alias gang jon marty steve evan darryl 

creates an alias gang^ which expands to the five people *jon’, ‘marty*, ‘steve’, ‘evan*, 
and ‘darryl’. If the given alias already exists, the listed names are added to it. 

cd Change current directory. Cd takes a single argument, the pathname of the direc¬ 

tory to change to. If no argument is given, cd changes to your home directory. 

copy Copy messages into a file without deleting them when you quit. See tave. 

delete Delete a list of messages. Reclaim deleted messages with the undelete command. 

dp Delete the current message and display the next message. The dp command is useful 

for quickly reading and disposing of mail. 

dt Same as dp. 

edit Edit individual messages using the text editor. Edit takes a list of messages as 
described under the type command and writes each into the file Meseagei (where ‘x’ 
is the message number being edited) for editing. When you have edited the message, 
write the message and quit. Mail reads the message back and removes the file. You 
may abbreviate edit to e. 

else Mark the end of the then-part of an if statement and the beginning of the part to 

take effect if the condition of the if statement is false. 

endif Mark the end of an if statement. 

exit Leave mail without updating the system mailbox or the file you were reading. Thus, 

if you accidentally delete several messages, use exit to avoid scrambling your mail¬ 
box. 

file List the names of the folders in your folder directory. Same as folder. 

folder or folder* 

Switch to a new mail file or folder. With no arguments, folder tells you which file 
you are currently reading. If you give it an argument name, it writes out changes 
(such as deletions) you have made in the current file and reads the new file. Use 
these special conventions for the name. 
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Name 

Meaning 

# 

Previous file read 

% 

Your system mailbox 

%name 

Name's system mailbox 

& 

Your "/mbox file 

-H folder 

A file in your folder directory 


from Display header lines for each message in a list. To display all the message headers 
from ‘lori’ for example, type: 

from lori 

1 lori Fri Jul 22 10:10:38 10/128 “Subject” 

2 lori Wed Jul 27 10:15:20 11/120 

5 lori Fri Jul 29 10:16:52 13/150 

headers Reprint the current list of message headers. When you start up mail to read your 
mail, it lists the message headers that you have. These headers tell you who each 
message is from, when it was sent, how many lines and characters each message has, 
and the ‘Subject:' header field if present. In addition, mail tags the message header 
of each message that has been the object of the preaerve command with a ‘P*. A 
flags messages that have been saved or written. Finally, deleted messages arc not 
shown at all. Headers (and thus the initial header listing) only lists the first so many 
message headers. The number of headers listed depends on the speed of your sys¬ 
tem. You can override this by specifying the number of headers you want with the 
screen command. Mail maintains a notion of the current ‘window’ into your mes¬ 
sages for the purpose of displaying headers. Use the z command to move forward 
and back a window. You can change the notion of the current window directly to a 
particular message by using, for example: 

6 headers 40 

to move maiTs attention to the messages around message 40. You can abbreviate the 
headers command to h. 

help Display a brief help message about the mail commands. 

hold Hold a list of messages in the system mailbox, instead of moving them to the mhox 
file in your home directory. If you set the binary option hold, this will happen by 
default. Same as preserve. 

if 

Execute commands in your .mailre file conditionally depending on whether you are 
sending or receiving mail with the if command. For example, you can do: 

if receive 

commands... 

endif 

An else form is also available: 
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Ignore 


list 

mail 


mbox 

next 


preserve 

Print 

print 

quit 


Reply 


if send 

commands,,, 

else 

commands,,, 

endif 

Note that the only allowed conditions are receive and send. 

Add the list of header fields named to the ignore list.* Header fields in the ignore list 
are not shown on your screen when you dbplay a message so you can suppress the 
display of certain machine-generated header fields^ such as Via which are not usually 
of interest. Use the Type and Print commands to display a message in its entirety, 
including ignored fields. If ignore » executed without arguments, it lists the current 
set of ignored fields. 

List the valid mail commands. 

Send mail to one or more people. If you have the ask option set, you are prompted 
for a subject to your message. Then you can type in your message, using tilde 
escapes as described earlier to edit, display, or modify your message. To send your 
message, type "D at the beginning of a line, or a *.* alone on a line if you set the 
option dot. To abort the message, type two interrupt characters (^C) in a row or 
use the ‘~q’ escape. 

Send a list of messages to mboi in your home directory when you quit. This is the 
default action for messages if you do not have the hold option set. 

Go to the next message and show it. If given a message list, next goes to the first 
such message and shows it. For example, to go to the next message sent by steve 
and show it, type: 

& next Steve 

You can abbreviate the next command to simply a newline, which means that you 
can go to and type a message by simply giving its message number or one of the 
magic characters **’, *.*, or *$*. So, to display the current message, type: 

And to display message 4, say: 

&4 

Keep a list of messages in your system mailbox when you quit. Same as hold. 

Like printf but also displays ignored header fields. See also print ignore. 

Display each message your on workstation. Abbreviate to p. Same as type. 

Leave mail and update the file, folder, or system mailbox you were reading. Mes¬ 
sages that you have examined are marked as *read* and messages that existed when 
you started are marked as 'old.* If you were editing your system mailbox and if you 
have set the binary option hold^ all messages which have not been deleted, saved, or 
mboxed are retained in your system mmlbox. If you were editing your system mail¬ 
box and you did not have hold set, all messages which have not been deleted, saved, 
or preserved are moved to the mbox file in your home directory. 

Reply to a single message. The reply is sent to the person who sent you the message 
to which you are replying, plus all the people who received the original message, 
except you. You can add people using the "I and ~c tilde escapes. The subject in 
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your reply is formed by prefacing the subject in the original message with *Re:^ 
unless it already begins so. If the original message included a *reply-to* header field, 
the reply only goes to the recipient named by ^reply-to.’ Type in your message using 
the same conventions available through the mail command. 

Reply to a one or more messages. The reply or replies if you are using this on multi¬ 
ple messages, is sent ONLY to the person who sent you the message, respectively, 
the set of people who sent the messages you are replying to. You can add people 
using the ‘"t* and ‘"c’ tilde escapes. The subject in your reply formed by prefacing 
the subject in the original message with *Re:’ unless it already begins so. If the origi¬ 
nal message included a ‘reply-to’ header field, the reply goes only to the recipient 
named by ^reply-to.* You type in your message using the same conventions available 
through the mail command. The reply command is especially useful for replying to 
messages that were sent to enormous distribution groups when you really just want 
to send a message to the originator. 

Reply to all names in the original message, regardless of how the replyall option is 
set. 

reply sender 

Reply to the sender only, regardless of how the replyall option is set. 

save Save messages on related topics in a file. Save takes as an argument a list of mes¬ 
sage numbers, followed by the name of the file in which to save the messages. The 
messages are appended to the named file, so you can keep several messages in the 
file, stored in the order they were put there. You can abbreviate the $ave command 
to s. You can save messages 1 and 2 in good.mail for example, by typing: 

& 8 1 2 good.mail 

Saved messages are deleted and not automatically saved in mhoz at quit time. They 
are not selected by the next command described above unless explicitly specified. 

set Customize mail with options or with valued options. See the Setting Custom Binary 

and Valued Options information that follows. Options can be binary, in which case 
they are on or off, or valued. To set a binary option on, do: 

set option 

where option is the option name. To give a valued option a value, say: 
set options value 

Several options can be specified in a single set command. 

Shell Escape to the Shell to type commands to it. When you leave the Shell, you return 
to mail. Mail assumes the default Shell, but you can override this default by setting 
the valued option SHELL: 

set SHELL =/bin/sh 

source Read mail commands from a file. It is useful when you are changing your .mailre file 
and you need to read in the changes. 

top Display the first five lines of each addressed message in a message list. It may be 

abbreviated to f. If you wish, you can change the number of lines that top displays 
by setting the valued option toplines. On a CRT terminal, you might prefer: 

set topnne8=10 


reply 


replyall 
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Type Displays each message with header fields. Identical to the Print command. 

type Display a Ibt of messages on your screen. If you have set the ert option to a 

number, and the total number of lines in the messages you are displaying exceeds 
that specified by ert, the messages are displayed by a paging program such as more. 
(Same as print). 

undelete 

Restore a deleted message. Only messages that have been deleted may be undeleted. 
This command may be abbreviated to ti. 

unset Reverse the action of setting a binary or valued option. 

visual Invoke a display-oriented editor. The operation of the visual command is otherwise 
identical to that of the edit command. Both the edit and visual commands assume 
some default text editors. You can override these default editors with the valued 
options EDITOR and VISUAL for the standard and screen editors. The defaults are: 

EDITOR»/usr/ucb/ex VISUAL—/usr/ueb/vi 

write Write the message into a file. Just like save, except that write deletes the first (nor¬ 
mally Trom:^ line) and last (normally blank) lines. Write has the same syntax as 
save and can be abbreviated to simply w. Thus, you can write the second message 
by doing: 

& w 2 file^ave 

I Move the message header window forward. Type: 

& »+ 

Analogously, you can move to the previous window with: 

k I- 

3.12.3. Setting Custom Binary and Valued Options 

This section describes each of the options in alphabetical order, including some that you have 

not yet seen. To avoid confusion, please note that the options are either all lowercase letters or 

all uppercase letters. We begin sentences with capitalised option names as a courtesy to English. 

Unless otherwise stated, the default value of all binary options is false (unset). 

EDITOR Define the pathname of the text editor to be used in the edit command and ^^e*. If 
not defined, ex is used. A valued option. 

SHELL Give the pathname of your Shell. This Shell is used for the command and ^"1^ 
escape. In addition, it expands filenames with Shell metacharacters like *** and in 
them. Default is csh. A valued option. 

VISUAL Define the pathname of your screen editor for use in the visual command and ^''v' 
escape. Invokes vi unless otherwise defined. A valued option. 

append Appends messages to the end of your mhox file rather than to the beginning. Nor¬ 
mally, messages are put in mhox in the same order that the system puts messages in 
your system mailbox. A binary option. This option is set in the system file 
fusrlliblMail.re. So by default, messages are appended to the end of the system 
mailbox and, your mhox file. You may override it in your .mailrc or your system 
administrator may remove it, if desired. 
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ask Prompt you for the subject of each message you send. If you respond with simply a 

newline, no subject field is sent. A binary option. 

askce Prompt you for additional ^carbon copy* recipients at the end of each message. 

Responding with a newline shows your satisfaction with the current list. A binary 
option. 

autoprint 

Cause the dehU command to behave like dt. After deleting a message, the next one 
is displayed automatically. This is useful for quickly scanning and deleting messages 
in your mailbox. A binary option. 

crt Designate the minimum numbers of lines displayed before the message is displayed 

by more for easier viewing. For example, set crt=30 causes any message longer 
than 30 lines to be displayed with more, A valued option. 

debug Display debugging information. Same as using the -d command line flag. A binary 
option. 

dot Cause mail to interpret a period alone on a line as the terminator of a message you 

are sending. A binary option. This is set in the default system file /usr/libfMaiLre, 
It may be removed or overridden in your ,mailre. 

escape Allow you to change the escape character used when sending mail. Only the first 
character of the escape option is used, and it must be doubled if it is to appear as 
the first character of a line of your message. If you change your escape character, 
then loses all its special meaning, and need no longer be doubled at the beginning 
of a line. A valued option. 

folder Determine the name of the directory to use for storing folders of messages. If this 
name begins with a */* mail considers it to be an absolute pathname; otherwise, the 
folder directory is found relative to your home directory. 

hold Hold messages that have been read but not manually dealt with in the system mail¬ 
box to prevent them from being automatically swept into your mboz, A binary 
option. 

ignore Ignore *C’s (or RUBOUT) characters from your system and echo them as *@*s* while 
you are sending mail. The "C characters retain their original meaning in mail com¬ 
mand mode. Setting the ignore option is equivalent to supplying the —i flag on the 
command line. A binary option. 

ignoreeof 

Make mail refuse to accept your current EOF character (*D by default) as the end of 
a message. Ignoreeof also applies to mail command mode, and is related to dot 

keep Truncate mail system mailbox instead of deleting it when it is empty. This is useful 
if you elect to protect your mailbox, which you do with the Shell command: 

tutorial^ chmod 600 /usr/spool/mail/yournamc 

where yourname is your login name. If you do not do this, anyone can probably 
read your mail. 

keepsave 

Retain all saved messages. When you save a message in a file, mail usually discards 
it when you quit. 

metoo Include yourself as a recipient when sending mail to an alias. Otherwise, mail does 
not send you a copy if you are included in the alias. A binary option. 
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nosave 

quiet 

record 

replyall 

screen 


Prevent mail from copying a partial letter to the de^dJetler file in your home direc¬ 
tory when you abort a message with two “C’s (RUBOUT’s). A binary option. 

Suppress the display of the mstY version when moiY is first invoked and the message 
number from the iffpe command. A binary option. 

Name a record file to save your outgoing mail. Each new message you send is 
appended to the end of the file. A valued option. 

Makes rep/y respond to everyone who received the message and /fepfp respond to the 
sender only. Setting replyall in the system-wide equivalent of .mailre called 
usr/lihlMail.re makes this the default and sets it for everyone. 

Override any terminal speed consideration that may affect how mat/ prints the mes¬ 
sage headers. Usually, the faster your terminal, the more it displays. The value of 
screen specifies how many message headers you want displayed. This number is also 
used for scrolling with the z command. A valued option. 


sendmail 

Use an alternate delivery system. Set the sendmail option to the full pathname of 
the program to use. Note: this is not for everyone! Most people should use the 
default delivery system. A valued option, set to the full pathname of the program to 
use. 


toplines 

Define the number of lines that the top command displays instead of the default five 
lines. A valued option. 

verbose Invoke sendmail with the -v flag to use verbose mode and announce expansion of 
aliases, etc. Equivalent to invoking mail with the -v flag. A binary option. 


3.12*4* Command Line Options 


This section describes the use of mail command line options. 

-N Suppress the initial printing of headers. For example, to get into maiY, type: 

tutorial^ mail —N 
& 


-d 

file 


-1 


-n 

—8 string 


-u name 


Turn on debugging information. Not of general interest. 

Show the messages in file instead of your system mailbox. If file is omitted, mail 
reads mbox in your home directory. 

Ignore tty interrupt signals while typing in a mail message. You can still use to 
interrupt the message. Useful on noisy phone lines, which generate spurious RUBOUT 
or DELETE characters. This is usually unnecessary if your INTERRUPT character is 
the default or if you*re not logged in over a phone line. (See the sttg Shell com¬ 
mand in the user^s manual for details.) 

Inhibit reading of fusrllib/MaiLre. 

Denote the subject of a message when sending mail. If string contains blanks, sur¬ 
round it with quote marks. 

Read names^s mail instead of your own. Unwitting others often neglect to protect 
their mailboxes, but discretion is advised. 
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—T file Arrange to print on file the contents of the articU-id fields of all messages that were 

either read or deleted. -T is for the readnewi program and should NOT be used for 
reading your mail. 

-V Use the -v flag when invoking sendmaiL This feature may also be enabled by set¬ 

ting the option verbose. Useful for diagnosing mail delivery problems. 

3.13. Message Format 

A sample message format is: 

From lori Wed Jul 27 10:16:52 1983 
Date: 27 Jul 83 10:16:45 PDT (Wed) 

From: lori (Lori Rosen) 

Subject: Company Cruise 

Message-Id: <8307271716.AA05188@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA05188; 27 Jul 83 10:16:45 PDT (Wed) 

To: alison 
Status: R 

Messages begin with a from line, which consists of the word ‘From’ followed by a user name, fol¬ 
lowed by anything (usually null), followed by a date in the format returned by the etime library 
routine described in the user's manual. The etime date may be optionally followed by a single 
space and a time zone indication, which should be three capital letters, such as PDT. 

Following the from line are zero or more header field lines. Each header field line is of the form: 

name: information 

Name can be anything, but only certain header fields are recognized as having any meaning. 
The recognized header fields are: article-id^ bcCf cc, fromj reply-tOj sender, subject, and to. Other 
header fields are also significant to other systems; see, for example, the current ARPANET mes¬ 
sage standard for more on this topic. A header field can be continued onto following lines by 
making the first character on the following line a space or tab character. 

If any headers are present, they must be followed by a blank line. The part that follows is 
called the body of the message, and must be ASCII text, not containing null characters. Each 
line in the message body must be terminated with an ASCII newline character and no line may 
be longer than 512 characters. If binary data must be passed through the mail system, it is sug¬ 
gested that this data be encoded in a system which encodes six bits into a printable character. 
For example, you could use the upper and lower case letters, the digits, and the characters 
comma and period to make up the 64 characters. Then, you can send a 16-bit binary number 
as three characters. Pack these characters into lines, preferably lines about 70 characters long 
as long lines are transmitted more efficiently. The file /usrjbin/uneneode and 
Iusribiniundecode are useful for encoding and decoding binary data into the recommended 
form. 

The message delivery system always adds a blank line to the end of each message. This blank 
line must not be deleted. 

The UUCP message delivery system sometimes adds a blank line to the end of a message each 
time it is forwarded through a machine. 

Note that some network transport protocols enforce limits on the lengths of messages. 
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3.14. Summary of Commands, Options, and Escapes 

This section gives a quick summary of the mail commands, binary and valued tet options, and 
tilde escapes. 

3.14«1. ‘mail’ Command Summary 

The following table describes the commands. 
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Table 3-1: mar/Commands 


Command 

Description 

! 

Single command escape to Shell 

- 

Back up to previous message 

Print 

Show message with ignored fields 

Reply 

Reply to a message 

Type 

Show message with ignored fields 

alias 

Define an alias as a set of user names 

alternates 

List other names you are known by 

cd 

Change working directory, home by default 

copy 

Copy a message to a file or folder 

delete 

Delete a list of messages 

dt 

Delete current message, type next message 

endif 

End of conditional statement; see if 

edit 

Edit a list of messages 

else 

Start of else part of conditional; see if 

exit 

Leave mail without changing anything 

file 

luterrogate/change current mail file 

folder 

Same as file 

folders 

List the folders in your folder directory 

from 

List headers of a list of messages 

headers 

List current window of messages 

help 

Print brief summary of mail commands 

hold 

Same as preserve 

if 

Conditional execution of mail commands 

ignore 

Set/examine list of ignored header fields 

list 

List valid mail commands 

mail 

Send mail to specified names 

mbox 

Arrange to save a list of messages in mboz 

next 

Go to next message and show it 

preserve 

Arrange to leave list of messages in system mailbox 

print 

Show messages 

quit 

Leave mail; update system mailbox, mbox as appropriate 

reply 

Reply to author of message only 

reply all 

Reply to message and all other recipients 

replysender 

Reply to message sender only 

save 

Append messages, headers included, on a file 

set 

Set binary or valued options 

shell 

Invoke an interactive Shell 

top 

Show first so many (5 by default) lines of list of messages 

type 

Show messages 

undelete 

Undelete list of messages 

unset 

Undo the operation of a set command 

visual 

Invoke visual editor on a list of messages 

write 

Append messages to a file, not including headers 

z 

Scroll to next/previous screenfull of headers 
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3.14*2. ‘set’ Command Option Summary 

The following table describes the options. Each option is shown as being either a binary 
valued option. 

Table 3-2: mail Binary and Valued Options 


Option 

Type 

Description 

EDITOR 

valued 

Pathname of editor for ^"e* and edit 

SHELL 

valued 

Pathname of Shell for theH ‘~r and M’ 

VISUAL 

valued 

Pathname of screen editor for ‘~v’, visual 

append 

hinarif 

Always append messages to end of mbosc 

ask 

binary 

Prompt user for ‘Subject:^ field when sending 

askcc 

binary 

Prompt user for additional ^Cc's^ at end of message 

autoprint 

binary 

Print next message after delete 

crt 

valued 

Set minimum number of lines before using more 

debug 

binary 

Display debugging information 

dot 

binary 

Accept alone on line to terminate message input 

escape 

valued 

Escape character to be used instead of 

folder 

valued 

Set directory to store folders in 

hold 

binary 

Hold messages in system mailbox by default 

ignore 

binary 

Ignore "C^s (RUBOUT) while sending mail 

ignoreeof 

binary 

Don^t terminate letters/command input with D 

keep 

binary 

Don^t unlink system mailbox when empty 

keepsave 

binary 

Don't delete saved messages by default 

metoo 

binary 

Include sending user in aliases 

nosave 

binary 

Don’t save partial letter in dead.letter 

quiet 

binary 

Suppress printing of mail version 

record 

valued 

File to save all outgoing mail in 

replyall 

binary 

Reverse action of rep/y and Reply 

screen 

valued 

Size of window of message headers for s, etc. 

sendmail 

valued 

Choose alternate mail delivery system 

toplines 

valued 

Number of lines to print in top 

verbose 

binary 

Invoke sendmail with the -v flag 


or 
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3.14.3. ‘mair Command Line Flags 

The following table shows the command line flags that mail accepts. 

Table 3>3: mail Command Line Flags 


Flag 

Description 

-N 

Suppress the initial printing of headers 

-•T file 

Article-id’s of read 

-d 

Turn on debugging 

-t file 

Show messages in file or “ 

• 

-1 

Ignore tty interrupt eignals 

~n 

Inhibit reading of 

-8 ftring 

Use string as subject in outgoing mail 

-T file 

Print article-id contents on file for read* 


news 

—u name 

Read name^s mail instead of your own 

-V 

Invoke sendmail with the —v (verbose) flag 


Note: Do not use -T and -d for normal operation. 


3.14.4. Tilde Escape Summary 

The following table summarizes the tilde escapes available while sending mail. 

Table 3-4: mail Tilde Escapes 


Escape 

e Arguments 

Description 

~! 

command 

Execute Shell command 

~c 

name ... 

Add names to ‘Cc:’ field 

~d 


Read deadJetter into message 

~e 


Invoke text editor on partial message 

~f 

messages 

Read named messages 

~h 


Edit the header fields 

~m 

messages 

Read named messages, right shift by tab 

> 


Display message entered so far 

“q 


Abort entry of letter; like INTERRUPT (*C or RUBOUT) 

"r 

filename 

Read file into message 

~s 

string 

Set ‘Subject:’ field to string 

~t 

name ... 

Add names to ‘To:’ field 

"v 


Invoke screen editor vi on message 

~w 

filename 

Write message on file 

1 

command 

Pipe message through command 


string 

Quote a ‘“’ in front of string 
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3.14.5. WiPHelp 

Following is the help summary displayed when you type: 

&T 


c <directory> 
d < message li8t> 
e <message list> 
f < message list> 
h 

m <user list> 
n 

p < message list> 
prc <message list> 

q 

r < message list> 

R < message Iist> 
s <messagel Iist> file 
t <message list> 
top < message list> 
u < message Iist> 
w <message list> file 
X 


chdir to directory or home if none given 
delete messages 
edit messages 

show from lines of messages 
print out active message headers 
mail to specific users 
goto and type next message 
print messages 

make message go back to system mailbox 

quit, saving unresolved messages in mbox 

reply to messages 

reply to sender (only) of messages 

append messages to file 

type messages (same as print) 

show top lines of messages 

undelete messages 

append messages to file, without from line 
quit, do not change system mailbox 
shell escape 


A < message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted, Mail uses the last message typed. 
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Mail Quick Reference 


Using Mail 

Commshd 

%mail ttfernameOttferAott 
%msil ttfemame 
%maU int€rmedk9§t\fuiern^m€ 
%inaU 

Quick Help 


Meaning 
Send to other host 
Send to same system 
Send to remote host 
Display headers, read mail 


c <dir> 
d <msg li8t> 
e <m8g li8t> 
f <m8g ii8t> 
h 

ra <u8er li8t> 
n 

p <m8g list> 
pre <m8g iiBt> 

<1 

R <m8g li8t> 
r <m8g li8t> 

8 <m8g li8t> file 
t <mBg list> 
top <msg list> 
u <m8g li8t> 
w <m8f list> file 

X 

! 

Tilde Escapes 


chdir to directory or home if none pven 
delete messages 
edit messages 

show from lines of messages 
print out active message headers 
mail to specific users 
goto and type next message 
print messages 

make message go back to system mailbox 

quit, saving unresolved messages in mbox 

reply to messages 

reply to sender only of messages 

append messages to file 

type messages (same as pnnt) 

show top lines of messages 

undelete messages 

append messages to file, without from line 
quit, do not change ^rstem mailbox 
shell escape 


Escape Arguments 
'! eemmand 

'e seme... 

'b asms... 

“d 

"e 

“t mtuagei 

'h 

"m mei§§ge§ 

"P 

“q 

"r 

"§ itring 

"t ssme... 


Meaning 

Ehcecute Shell command 

Add names to ‘Cc:* field 

Add names to ‘Bcc:’ field 

Read dead.Utter into message 

Invoke text editor on partial message 

Read named messages 

Edit header fields 

Read mess apes shifted right by tab 
Display message entered so far 
Abort entiy of letter, like 
Read file into message 
Set 'Subject:* field to $tring 
Add names to ‘To:* field 


V Invoke vt on message 

w Jtename Write message on file 

esmmsad Pipe message through commani 
ttrtM ^uote a *■'* in front of §tring 

Command Line Optiona 


Mall Command# 


Command 

I 

Print 

Reply 

Type 

alias 

alternates 

cd 

copy 

delete 

dt 

endif 

edit 

else 

exit 

file 

folder 

folders 

from 

headers 

help 

hold 

if 

ignore 

list 

mail 

mbox 

next 

preserve 

print 

quit 

reply 

replyall 

replysender 

save 

set 

shell 

top 

type 

undelete 

unset 

visual 

write 

s 


Meaning 

Command escape to Shell 
Back up to previous message 
Show message with ignored fields 
Reply to message 
Show message with ignored fields 
Define an alias as set of user names 
List your other 'names’ 

Change working directory (home default) 

Copy a message to file or folder 

Delete list of messages 

Delete current, type next message 

End of condition^ statement 

Edit message list 

Start of else part of conditional 

Leave mail without changing anything 

Interrogate/change current mail file 

Same as fite 

List folders in your folder directory 
List headers of list of messages 
List current window of messages 
Show command summary 
Same as prettrvt 

Conditional execution of matV commands 
Set/examine list of ignored header fields 
List valid mail commands 
Send mail to specified names 
Save list of messages in mbog 
Show next message 

Leave list of messages in system mailbox 
Show messages 

Leave matl, update system mailbox or mboi 

Reply to author of message only 

Always reply to all names in the original message 

Always reply only to sender 

Append file with messages and headers 

Set binary or valued options 

Invoke interactive Shell 

Show first n (5 default) lines of list of messages 

Show messages 

Undelete list of messages 

Undo operation of a ict command 

Invoke visual editor on list of messages 

Append messages to file, not including headers 

Scroll to next/previous screenful of headers 


Option Action 

-N Suppress initial display of headers 

“T file Article-id’s of read/deleted messages to file 

-d Turn on debugging 

-f file Show messages in file or '/mbog 

-i Ignore tty interrupt ngnals 

-n Inhibit reading of /uer/lib/MaU,rc 

-s etring Use etring as subject in outgoing mail 
>T fiU Print artiele^id contents on jUe for read- 
news 

-u name Read name’s mul instead of your own 

-V Invoke eendmail with -:V 

Notes: Do not use -T and -d for normal operation. 
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Set Binary and Valued Options 

Option 

Type 

Meaning 

EDITOR 

valued 

Editor pathname for ‘“e*, edit 

SHELL 

valued 

Shell pathname for ‘"1’, *!’ 

VISUAL 

valued 

Screen editor pathname for ‘''v^ vimal 

append 

binary 

Append messages to end of mbos 

ask 

binary 

Prompt user for ‘Subject:’ when sending 

askec 

binary 

Prompt user for additional ‘Cc’s’ at end 
of message 

autoprint 

binary 

Print next message after delete 

crt 

valued 

Set minimum number of lines before us> 
ing more 

debug 

binary 

Display debugging information 

Accept alone to terminate message 

input ^ 

dot 

binary 

escape 

valued 

Escape character instead of 

folder 

valued 

Set directory to store folders in 

hold 

binary 

Hold messages in system mailbox by 
default 

ignore 

binary 

Ignore *C’s while sending mail 

ignoreeof 

binary 

Don’t terminate letters/command input 
with D 

keep 

binary 

Don’t unlink system mailbox when 
empty 

keepsave 

binary 

Don’t delete saved messages by default 

metoo 

binary 

Include sending user in aliases 

nosave 

binary 

Don’t save partial letter in dead.letter 

quiet 

binary 

Suppress display of mail version 

record 

valued 

File to save all outgoing mail in 

replyall 

binary 

Reverse actions of reply and Reply 

screen 

valued 

Window sise of message headers for z, 
etc. 

Choose alternate mall delivery system 

sendmail 

valued 

toplines 

valued 

Number of lines to print in top 

verbose 

binary 

Invoke eendmail with -v 
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Chapter 4 


Network News User's Guide 


The network news, or simply netntw$y is the set of programs that provide access to the User’s 
Network called USENET. This chapter describes how to use the network news and related pro¬ 
grams and provides a quick reference page for easy use. 

With netnewBy you can post news articles for limited or very wide distribution on the USENET. 
You can post an article, which will be sent out to the network to be read by others interested in 
that topic. There are facilities for browsing through old news, posting follow-up articles, and 
sending direct electronic mail replies to the author of an article. 

Whenever you read the news, you are presented with interesting articles that you have not yet 
read. These are divided into topics or new$groupt. You can specify which topics you are 
interested in with a subscription list. At the end of this guide, there is a list of newsgroups to 
help you determine which newsgroups you may want to subscribe to. Netnews keeps old articles 
around until they expire, which is usually about two weeks, so you can browse through old news 
from time to time. 

USENET is a bulletin board shared among many computer systems in the computer science com¬ 
munity, around the United States, Canada, Europe, and Australia. USENET is a logical network, 
sitting on top of several physical networks, including uucp, BLION, and Berknet. Sites on 
USENET include many universities, private companies and research organizations. 

USENET is useful in a number of ways: 

• to share useful information, 

• to report bugs and fixes without mass mailings, and 

• to have discussions involving many people at different locations without having to get 
everyone together. 

For additional options and details on the network news, refer to the user’s manual on readnews, 
checknewSy postncws, and inews. 


4,1 ♦ Making the Connection with Your News Host System 

To use netntwSy a host system at your site (the news host) must connect regularly by uucp to 
another site from which news can be forwarded. This must be arranged directly between your 
system administrator and the forwarding site. See the System Manager's Manual for the Sun 
Workstation for more information. If your system itself is the news host, you can run readnews 
directly. If the news host is another machine on your local Ethernet, you must do a remote 
login {rlogin). Let’s assume your news host system is called ‘mercury’. Log in to ‘mercury’ by 
typing: 


The material in this guide is derived from How to Read the Network Newa, Mark R. Horton, Bell 
Telephone Laboratories. 
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tutorial^ rlogin mercury 

Last login: Tue Aug 5 13:41:36 on ttypO 

Sun UNIX 4.2 (Berkeley beta release) (GENERIC) #8; Oct 23 13:45:52 PDT 1983 
mercury% 

You are now ready to read the news. 

For additional information on how to connect your system to the USENET, refer to the Syttem 
Manager’s Manual for the Sun Workstation. 

When you are finished reading the news, use to logout from the news host: 

mercury% *D 
Connection closed. 
tutorial% 


4.2. How to Read the News with ‘readnews* 

The following assumes that your system ‘mercury%’ is directly hooked up to USENET via uucp. 
Use the readnews command to read the news: 

mercury% readnews 
Header of news article 

For each newsgroup to which you subscribe is displayed, one article at a time will be presented. 
You will be shown the article header, containing the name of the author, the subject, and the 
length of the article. You are asked if you want to read more. The three most common 
responses are: 

• Type y for ‘y®®’ (or simply press RETURN) to display the rest of the message. A at 
the end of a long message indicates that readnews is waiting for you to finish reading 
the displayed part of the message before the next header forces it off the top of the 
screen. Type a space or press RETURN to see more of the message. 

• Type ^n^ for ^no^ to indicate you are not interested in the message; it will not be offered 
to you again. 

• Type ‘q’ for ‘quit’ to make a record of which articles you read (or refused) and to exit 
netnews. When you have read all the news, this happens automatically. The quit com¬ 
mand is useful if you are in a hurry and don’t have time to read all the news right now. 
This updates .newsrc if the -I or -x options are not used. 

To see a complete list of possible responses, type *?’ for help. 


4.3. Reading News for the First Time 

If you are reading news for the first time, you may find yourself swamped by the volume of 
unread news, especially if the subscription list default is ‘all’. Decide which newsgroups you 
want to read about. If you are getting newsgroups in which you have no interest, you can 
change your subscription list as we show below. Also, bear in mind that what you see is prob¬ 
ably at least two weeks accumulation of news. If you want to just get rid of all old news and 
start anew, use the readnews command with the -*p and —n options, which throw away all arti¬ 
cles and any diagnostic output into /dev/null, the “wastebasket” file. Note that this take a 
long time, so it’s best to run the command in the background by typing an *&’ at the end of the 
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command line: 

mercury% readnews -p all > /dev/nuU & 

[1] 2345 
mercury95 

This throws away all old news, recording that you have seen it. 

Once you catch up or ignore all the old news, the news comes in daily at a more manageable 
rate. If the daily rate is still too much you may wish to change your subscription list to exclude 
some of the high volume newsgroups. Finally, note that while you are displaying an article, you 
can type a (an INTERRUPT or DELETE) to throw away the rest of the article. 

Other commands you can type after seeing the article header are: 

U Unsubscribe from this newsgroup. Goes on to the next group. Your ,new9rc file 

is edited to change the for that newsgroup to an preventing you from 
being shown that newsgroup again unless you edit your .nctrsrc file (see below). 

X Exit readnetvt. Unlike quiiy does not update the record of which articles you 

have read and pretends you never started readnews. 

N newsgroup 

Go on to the next newsgroup. The remaining articles in the current newsgroup 
are considered Unread* and are offered to you again the next time you read 
news. 

8 filename 

Save the article in a file with the given filename. What usually happens is that 
an article is displayed, and then readnews goes on to display the header of the 
next article before you get a chance to type anything. To write out the previous 
message, that is, the last one you have read in full, use the form 8 - filename. 
Article is appended to file. Default is Articles, 

r Reply to the author of the message. You are placed in the editor with a set of 

headers derived from the message you are replying to. Type in your message 
after the blank line. If you want to edit the header list to add more recipients 
or send carbon copies, for instance, you can edit the header lines. Anyone listed 
on a line beginning with “To:” or “Cc:” will receive a copy of your reply. A 
mail command is then started up, addressed to the persons listed in the header. 
Exiting the editor returns you to readnews. Use r- to reply to the previous mes¬ 
sage. Beware that this may sometimes generate an incorrect address. Check the 
address and correct it with if necessary. Another variation on this is rd-, 
which puts you in IMAILER or mail by default, to type in your reply directly. 

f Post a follow-up message to the same newsgroup. Type in the body of your 

reply and type "D. This posts an article on this newsgroup with the same title 
as the original article. Be sure your article is worthy of posting; many follow-up 
articles should be replies. Use to follow up the previous message. If you 
type this by accident, type (an INTERRUPT) to abort the follow-up. Note 
that the people who administer the machines on USENET are concerned about 
people sending news to inappropriate newsgroups. We suggest you read several 
week's worth of news and read up on network etiquette before posting any news. 

-I- ft Skip the article for now or skip n articles. The next time you read news, you 

are offered this article again. 

- Go back to the previous article. This toggles, so that two ‘-”s get you the 

current article. 
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d Divide digest article, 

c Cancel an article you posted, 

r Reply to article author via maii 

t title Post follow'Up article to the same newsgroup. This posts an article on this 

newsgroup with the same title as the original article. You are placed in the edi¬ 
tor. Enter your message and exit. The f- command follows up a previous mes¬ 
sage. Another case, fd- allows you to type the follow-up in directly without 
having to use an editor. If you start this by accident, type "C to abort the 
follow-up. The default editor is vi unless you set it otherwise in your environ¬ 
ment. 


8 


e 

h 

! 


command 

Run command with article as input. 

Erase. Forget that this article was read. It will be offered again. Use e- to see if 
there have already been followups to the article. 

Shows the verbose article header with article ID path the date or the news- 
groups; also H for an even more verbose header. 

Escape to Shell to execute command. 


number Go to article number. 


V Display current version of news software. 

D Decrypt crypted jokes. 

X eystem Send article to system. 

? Display a summary of valid commands. The is also displayed if you type any 

unrecognized command. 

Put a after c , r , f , e , 8 , and h to indicate the previous article. 


4.4* Printing a News Article 

To print a news article, save it in a file with 8 filename^ and then send it to your printer: 

Article 10 of 12, or general; Mon 11:12. 

Subject: HP2621P Function Keys 

Path: .. !cbosgd!henry 

Newsgroups: bt 1 .general,net .followup 

(31 lines) More? [ynq] 8 hp.function .key 8 

./hp.function.keys: New file 

(31 lines) More? [ynq] q 

mercury% pr hp.function.key8 | Ipr -Imprinter 
mercury% 

Remember that if you decide you want to write an article to a file after you have read it, you 
have to use the to indicate the previous article: 

(31 lines) More? [ynq] 8- hp.function.key8 
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4.S. Changing Your Subscription List 


If you dontake any special action, you will subscribe to a default subscription list. This 
default varies locally. To find out your local default, type: 

mercury^ readnewa -a 

Subscription list: general,all.general,general 

Typically this list includes all newsgroups ending in ^generaF, such as *general\ and 
‘net.general’. 

To change this, create a file in your home directory named .ntw$rc and type as its first line: 
options —n newsgroup newsgroup newsgroup ... 

Continue long lines on subsequent lines by beginning them with a space. The netnews system 
updates this file by writing update lines to record which articles you have read. Ignore these 
lines unless you want to edit them. For example, if you are creating a subscription list for the 
first time, and have already read news, you will find some update text in your .ncwsrc file, 
recording which articles you have read. Put your options line before the first line of the file. 
For instance, a ,newsre file can look like: 

options -n general net.ai fa.teleeom 

net.chess: 1-224 
net.games.rogue: 1-45 
net.games.trivia: 1-234 

The update text shows three articles and the opfton# lines that subscribes to the three news* 
groups, ‘general,’ ‘net.ai’, and ‘fa.telecom.* 

The easiest way to subscribe to news is to subscribe to “all”, and then use the “U”to unsub¬ 
scribe to newsgroups you don’t want to read. This way you will see new newsgroups as they 
are created, get a chance to evaluate them, and then unsubscribe to those that don’t interest 
you. 

To exclude certain newsgroups, you can also type: 

! newsgroup 

and add the word ‘all’ as a wild card to represent any newsgroup. You can also use ‘all’ as a 
prefix or suffix to match a class of newsgroups. For example: 

options -n all !fa.all Inet-jokes lalLunix-all 

subscribes to all newsgroups except for ARPANET news, jokes, and any UNIX information. The 
metacharacter is like ‘/’ to the Shell, and ‘all’ is like 


4,6. Submitting New Articles with ‘postnews’ 

Use the postnews command to submit a news article on a new topic. You are prompted for an 
article subject, newsgroup(8), article distribution, and your news. You are then put in the edi¬ 
tor. Enter the text of your article after the blank lines, and exit the editor. This sends your 
article immediately. 
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mercury% postnews 
Subject: 

Newsgroups (general): 

Distribution (general): 

Type news, exit editor 
mercury^ 

Typing RETURN after the ^Newsgroups* and ^Distribution* prompts uses the default newsgroup, 
^general.* That may be a larger distribution than you want. To change the distribution, type 
the name of the newsgroup class you want the article distributed to. Although you can use any 
newsgroup name, ordinarily you*ll just type the name of the newsgroup class, such as *U8a* or 
*net*. Take an extra moment to think about how applicable your news is, and to what area of 
the country or world. Sending messages to people who have no interest in them is one of the 
most annoying problems on the net today. When creating a new article, specifying the news- 
group controls the level of distribution. 

If you change your mind about the headers while you are still in the editor, you can edit them 
as well. You can also add extra headers before the blank line. 

If your article is related to a previous article, you should use the f followup command to read- 
news, instead of posting a new article. This creates an article with references to the previous 
article, so that persons who are not interested in the topic can shut it off. 

You can also use: 

mercury% postnews {dename 

in which case postnews uses the specified filename as the article. 

If you make a mistake, get out of the editor without writing the article with :q for example. 
Inews lets you know that your incomplete news article was not sent: 


2q 

inews: You didn’t really want to post THAT!. 
Article saved in /usr2/lori/dead.article 


4.7. Submitting News with ^inews’ 

You can also use the inews command to send news. Inews provides several options for specify¬ 
ing such additional information as the article expiration date and the name of the sender. A 
sample inews format is: 

mercury% inews -t title -n newsgroup [-e expiration dat^ [-f sender] 
body of article 
D 

EOT 

mercury% 

Inews does not prompt you like postnews does. 

You can also use an editor with inews to prepare the body of your article. Edit your file, then 
type: 

mercury^ inews -t title [-n newsgroup] < file 
to send the edited file as your news article. A sample command line looks like: 
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mercury^ inewn -t seminar -n net.micr6 next friday < seminfo 

This article announces a seminar to the *net.micro* newsgroup readers. This expiration date 
option is useful if you are announcing a meeting for a particular date after which the announce¬ 
ment will no longer be yalid. 

On some systems, it is possible to post news articles by sending mail. See the section on mail in 
User Interfaces in this guide or refer to mail in the user*8 manual. 


4.8. Browsing Through Old News 


Readnews command line options that help you find an old article again are: 


-n newsgroups 

Restricts your search to certain newsgroups. 

-X Ignores the record of articles read kept in your .newsre file. This displays all articles 

in all newsgroups to which you subscribe, even those which you have already seen. 
It also prevents readnews from updating the .newsre file. 

-m date Asks for news received since the given date. Note that even with the —a option, only 
articles you have not already seen are displayed, unless you combine it with the -x 
option. Articles are kept on file until they expire, typically after two weeks. 


—t titles 


’A 

”P 


~r 

-f 

-h 


Restricts the query to articles mentioning one of the titles in the title of the article. 
If you try: 

mercury % readnews -n net .unix-wizards -x -a last friday~t setuid 

you see all articles in newsgroup net.unix-wizards since last Friday about the setuid 
feature. The -t option finds articles about the specific keyword; it does not find arti¬ 
cles about 'suid\ ‘Setuid*, nor articles with no title or whose author did not use the 
word ‘setuid* in the title. 

Lists only the headers of articles — a useful form for browsing through lots of mes¬ 
sages. 

Prints the messages without asking for any input. 

Produces articles in reverse order, from newest to oldest. 

Prevents any follow-up articles from being printed. 

Prints articles in much less verbose format. 


4.9. Getting News When You Log In — Your Morning Newspaper 

To be told if there is any news when you first log in, put ckeeknews or readnews in your .login 
or .profile file on your account on your news host. This way you are reminded of news when 
you log in to the news host. 

The readnews command tries to find all unread news (assuming you are going to read it), and 
takes a lot of time to do it, so it’s better to use the smaller, faster ehecknews, which tells you if 
there is any news. Ckeeknews was designed especially for a login file. There are also options to 
be silent if there is or is not news, and to start up readnews automatically if there is news. 
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The ckecknewB options are: 

-y Print ‘There is news’ if there is any news arriyes during a login session. This is the 

default if no other options are specified. 

-V If both -V and -y are given, instead of printing ‘There is news’, print ‘News: news* 

group ...’ giving the name of the first newsgroup containing unread news. 

-n Print ‘No news’ if there is no unread news. 

—e Start up readnewi if there is any unread news. Any additional arguments after the 

-e are passed to readnewi, 

-q Make checknewi quiet. The exit status indicates news: 0 means ‘no news’ and 1 

means ‘there is news.’ It does not print a message. 

Thus, checknewi ~yn tells you whether there is any unread news. Checknewi -y tells you if 

there is news, and is silent if there is no news. 


4,10* Creating New Newsgroups 

To create a newsgroup, post an article to an appropriate ‘general’ newsgroup suggesting the new 
newsgroup. For example, for a new ‘net’ or *fa’ newsgroup, post to ‘net.general’ or for a new 
local newsgroup, post to ‘general’. Include another copy to ‘net.news.group’, for example: 

mercury^ postnews 

Subject: Suggested new newsgroup on Celtic Culture and Language 
Newsgroups: net.general, net.newB.group 

mercury^ 

Other users will follow-up to ‘net.news.group’, giving opinions about whether the suggested 
newsgroup makes sense, should have a different name, etc. 

When agreement is reached and it is established that there is interest in the topic, ask your 
local netnews administrator to create the newsgroup. It can actually be created by any netnews 
administrator anywhere on the net, within the scope of the newsgroup. Once the newsgroup is 
created and the first article has been posted, the newsgroup is available for all interested per¬ 
sons to post to. 


4.11. User Interfaces 

The user interface of a program is the face it presents to the user, that is, what it displays and 
what it allows you to type. Readnewi has options allowing you to use different user interfaces. 
These are: 

-c The -c option displays the the entire message, header and body, and prompts 

you at the end of the message. The command options are the same as the msgs 
interface, but it is usually not necessary to use the ‘*’ suffix on the rep/y, iave, or 
followup commands. This interface is called the ‘/bin/mail’ interface, because it 
mimics the UNIX program of that name. 

mail The matV interface, available with the —M option, invokes the mail program 
directly, and allows you to read news with the same commands as you read mail. 
This interface may not work on your system - it requires a special version of 
mail with a -T option.) 
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• Use your favorite mail system as an interface, including /bin/mail and mail. 

Any mail system with an option to specify an alternative mailbox can be used to 
read news. For example, to use mail without the -M option, type: 

mercury^ readnewa -c "mail -f 

The Shell command in quotes is invoked as a child of readnews. The -f option to mail names 
the alternative mailbox. Readnews puts the news in a temporary file, and gives the name of 
this file to the mailer in place of the *%\ There is an important difference when using this kind 
of interface. The mailers do not give any indication of which articles you read and which ones 
you skipped. Readnews assumes you read all the articles, even if you didnH, and marks them 
all read. By contrast, the ~M option uses the -T option to mail, asking mail to tell readnews 
which articles you read. 


4.12. Rules of the Net 

The network news provides a unique method of communication for many people. Some news* 
groups are intended for discussions and some for announcements or queries. Try to keep this in 
mind when posting or responding to an article. If you are unhappy with what some user said, 
send that user mail. Please consider the following guidelines when using USENET and the net¬ 
work news: 

• Put all items in an appropriate group. 

• Use mail instead of a followup news item. 

• Be careful when preparing articles for submission. 

• Read followups before responding. 

• Use an editor to prepare items for submission. 

• Don’t be rude or abusive. 

• Avoid sarcasm and facetious remarks. 

• Use descriptive titles. 

• Whenever possible, cite references. 

• Make a summary of the original item in followups. 

• In posting summaries of replies, do make a summary. 

• Don’t force people to read the same thing more than once. 

• Be as brief as possible. 

• Follow local customs. 

• Be fair — Remember that the net is a large audience. Be sure of your facts. 

• Mark puzzles. 

• Do not submit items berating violators of these rules. 

Puzzles are questions to which you know the answer. When submitting a puzzle, make it clear 
that you know the answer to prevent others from putting the solution into followup articles and 
to avoid having other people who know the solution from feeling they have to help you find the 
answer. 

Before posting an article, think about where it is going. If you post it to a “net.” newsgroup, it 
goes to the USA, Canada, Europe, and Australia. For articles of local interest, use the inewa -n 
ntwagroup feature to restrict distribution to certain newsgroups in your local area. 
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The net is not intended for advertising. You may provide informative announcements or profes¬ 
sional products or services on USENET, but they should be of benefit to everyone on the net. 
Mark your announcement as such in the subject. Post the announcement to the appropriate 
newsgroup, never a general-purpose newsgroup such as net.general. Never repeat such an 
announcement and submit only one article per product. 

Some newsgroups are moderated, such as net.announce. In these groups, you cannot post 
directly, either by convention or because the software prevents it. To post to these newsgroups, 
send mail to the moderator. 

Some newsgroups have special purpose rules. Consider the following newsgroups and rules for 
their use. 

net.announce 

Moderated. No direct postings. Good for short announcements and queries that 
need to reach everyone on the net. To post an important announcement for 
everyone send mail to the net.announce moderator at cbosgdfannounce. 

net.general 

Announcements only. No discussions. 

net.general 

Short announcements an queries that require a wide audience, but are inap¬ 
propriate for net.announce. Results of surveys. No discussions. 

net .follow up 

For followups to items in net.general. 
net.misc For discussions that have no other natural location, 
net .wanted 

For posting queries for help, such as “I want an x.” No discussions. Try to 
limit the distribution to a reasonable geographic area. Not that some institu¬ 
tions have rules against using computers for such purposes. 

net.flame All the rules are off in this newsgroup. Total anarchy prevails. 

net.jokes Clean jokes only. Anything offensive must be encrypted. No discussions. Jokes 
only. Discussions go in net.jokes.d, 

net.movies Don't post anything that reveals the plot of a movie without marking it 
“spoiler" in the subject. 

net.news Discussion of all aspects of USENET itself, 
net.news.group 

Before you create a new group, submit an item here and to specific groups that 
may share interests with your proposed new group. If after a week or two, you 
have received support for the idea and no serious objections, go ahead and create 
the group. Also create an item in the new group with a distant expiration date 
describing wht the group is about. 

net .sources 

F or useful programs and shell scripts after they are announced in some appropri¬ 
ate place. These programs should be well commented so that people who miss 
the announcement can understand what they do. 

net.test For USENET administrators to test the functioning of the software. Use net.test 
only as a last resort as items posted here go to all machines. Try “mh.test”, 
“test” or “ucb.test” as smaller test group. 
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net.women.only 

Men are discouraged from participating and are forbidden from criticizing a 
topic or person in this newsgroup. 

4.13. Frequently Asked Questions 

If you are a newcomer to the USENET, read over the following frequently submitted items. 

• What does UNIX stand fort 

UNIX is not an acronym but a pun on *‘MULTICS.” MULTICS is a large operating system 
that was being developed at Bell Laboratories about the same time as UNIX was created. 

• What does (nf)” in a news item's title mean? 

It means that the item was created by *'notefiles," an alternative netnew$ interface. 

• What does “:-) ” mean? 

Thb is the net convention for a **smiley face," indicating that something b being said in 
jest. 

• How do I decrypt jokes in net.jokes? 

The standard cypher used in net.jokes is called rotiS. Each letter is replaced by the 
letter 13 letters farther along in the alphabet, wrapping around at the end of the alpha> 
bet. You can create a shell script with the tr (translate) command to do the same 
thing. See tr in the U$er*$ Manual, 

• Where can I get the source for empire or rogue? 

The source for empire and rogue is not available at the request of their authors. 

4.14. From the ARPANET 

The TA' (from the ARPANET) newsgroups have a different convention for posting news. Rather 
than using tuctrs, po$tncw$y or the foUowup command, send mail to a particular electronic mail* 
ing address along the return address found in the *Trom" line of the article. 

The correct way to post news to an TA' newsgroup is to send electronic mail to 
uebvax!C70:ficwsyroup. (You will have to route your mail to ucbvax * inquire locally how to 
do thb or check the return address on any *FA' article.) For this reason, all articles in ‘FA’ 
newsgroups have a return address of the form ...!ucbvax!C7O:nctrs0roup. 

‘Fa* newsgroups are electronic mailing Ibts on the ARPANET. A number of people on the 
ARPANET get the mailings directly from the mailing lists. One entry on each mailing list is of 
the form posi-nctrsyroupOBerkeley which is fed into a program that posts the article on news- 
group ttk,ncwdgroup. From there it is distributed to the other sites on USENET. If you post an 
article directly to the newsgroup, you will reach all the readers of that newsgroup on USENET, 
but you will mbs all the people getting the direct mailing on the ARPANET. 

To follow up an ‘FA’ article, use the reply command of readnews, not the foUouhup command. 
Thb insures that ARPANET members also see the reply. 

If you are a USENET site on the ARPANET, the corresponding mailing address is 
netrjprotip@Berkeley, although it also works to send mail directly to the ARPANET list, if you 
know the proper address. The address at Berkeley only forwards to the real ARPANET mailing 
Ibt. Thus, for example, sending mail from the ARPANET to either CSVAX.unix- 
wiaardsOBerkeley or unix-wisardsOSRI-WARF b correct, but sending mail to 
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CSVAX.post-Unix-winards^Berkeley is wrong, since only USENET readers will see it. 

4.16. List of Newsgroups 

This lists the active newsgroups to help you decide which you want to subscribe to. Note that 
the list is constantly changing; about five new lists are added each month. Note also that this 
list is specially tailored for the Berkeley sites. Check with your netnews adminbtrator for a 
local Ibt. 

There are two basic subcategories of netwide newsgroups: 

1. The ^net.air group consists of USENET bulletin board newsgroups that are circulated around 
the entire net. 

2. The Ta.air group is a set of groups that are connected by gateways to USENET from the 
ARPANET. These groups consist mainly of digests, although there are some bulletin boards. 

Some of the ‘net.alP and ‘fa.alF groups are gatewayed between the networks, that b, items sub¬ 
mitted from the ARPA side to the digest are split up and submitted to the USENET group, while 
articles submitted on the USENET side are bundled up and submitted to the digest. 

4.15.1. Local Newsgroups 

Local groups are kept on the current machine only. Local names can be identified by the lack 
of a prefix, that is, there are no periods in local newsgroup names. 

general News and important announcements to be read by everyone on the local 

machine. This newsgroup is usually mandatoiy so insure that important 
announcements reach all users. Thb newsgroup is usually mandatory. The 
list of mandatory newsgroups varies locally. 


4.15.2* FA Newsgroups 

FA groups are Trom the ARPANET^ and are mostly copies of mailing lists or 'digests* dbtributed 
on that network. A digest is a collection of mail, much like a newsletter, that b put together by 
an editor and sent out every so often. A special convention applies to submissions to FA news- 
groups. As previously described, you should not post directly to the newsgroup, since thb will 
be seen by people on USENET but not by the people on the ARPANET who get the list directly 
mailed to them. Instead, send mail to the return address on any article, by using the reply com¬ 
mand to readnews. For example, to post to fa.human-net8, the reply command might mail to 
ucbvax!C70:human-nets 

FA groups and their corresponding mailing lists can reach a very large user community, includ¬ 
ing USENET sites on UUCP, Berknet, BLN, and the ARPANET, as well as sites on the ARPANET 
which are not on USENET, who get the news via dbect electronic mailing. 

fa.arms-d People worried about nukes. 

fa.arpa-bboard Announcements that are posted to all arpanet boards are also fed into thb 
newsgroup. 

fa.digest-p People who deal with digests. Mostly the people who moderate them. 

fa.editor-p Interest group in computer editors, both text and program. 
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fa.energy 

fa.human-nets 


fa.info-cpm 

fa.info-micro 

fa.info>terms 

fa.info-vax 

fa.poli-sci 
fa.sf-lovers 
fa.space 
fa.tcp-ip 
fa. telecom 

fa.teletext 

fa.unix'cpm 
fa. works 


Topics relating to alternate energy production, conservation, etc. 

A daily moderated digest with discussions of computer-aided human*to- 
human communications. Probably the most widely read ARPANET publica¬ 
tion. 

CP/M and other operating systems for micro computers. 

Microprocessor discussions. 

Opinions/queries about what*8 a good/bad computer terminal. 

VAX interest group. Seems to be mostly VMS issues, but some hardware dis¬ 
cussions too. 

Political Science discussions digest. 

Science Fiction book/movie reviews, etc. 

Digest containing comments on the space program and outer space in general. 
Digest relating to the TCP and IP network protocols. 

Technical topics relating to telecommunications, especially the telephone sys¬ 
tem. A digest recently spun off from fa.human-nets. 

Teletext discusses all aspects of **esoteric” data systems. This includes 
teletext, viewdata, closed-captioning, and digicasting. 

CPM/UNDC discussions. 

Interest group on personal workstations (e.g. Apollo, Perq, Sun, Xerox Star, 
etc). 


4.15.3* Net Newsgroups 


Net groups are intended to be available to all people on the entire network who read netnews. 
This does not mean they go to every machine, since some machines restrict the volume of news 
that comes in. Net groups reach all of USENET, including USENET sites on the ARPANET, but do 
not reach any sites that are not on USENET. That is, USENET is defined as all sites that receive 
‘net .general’. 

net.general Articles to be read by everyone on the whole net. 

net.applic Functional programming (applicative) languages. 

net.auto Notes of interest to owners of particular cars. Main subgroup is net.auto.vw. 

net.auto.vw For owners of Volkswagen Rabbits, 

net.aviation Private pilots. 


net.bugs Bug reports and fixes. Subscribing to ‘net.bugs’ gets all bug reports, but bugs 

are normally posted to one of ‘net.bugs.2bsd’, ‘net.bugs.4bsd’, ‘net.bugs.v7’, or 
‘net.bugs.u3’, for the 2nd and 4th Berkeley Software Distribution, Version 7, 
or UNIX system III, as appropriate. 


net.chess Interest group for computer chess. This newsgroup is connected into an 

ARPANET mailing list but appears as a normal newsgroup to USENET, so it is 
called ‘net.chess’ instead of ‘fa.chess’. 


net.columbia 
net .cooks 


Newswire items and comments on the Space Shuttle, and on the space pro¬ 
gram in general. 

Food, cooking, cookbooks, and recipes. 
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net .cycle 
net.eunice 

net .games 

net.ham-radio 
net .jokes 
net.Ian 
net.lsi 
net.misc 

net .movies 
net .music 
net.news 


net.oa 

net.periphs 

net.rec 


net .records 
net .rumor 
net.sf-lo vers 
net .sources 
net.space 
net .sport 

net .taxes 
net .test 

net .travel 
net.ucds 

net.unix-wizards 


Motorcycle interest group. 

Topics of interest to sites running SRI’s Eunice system, which simulates UNIX 
on VMS. 

Discussion of computer games (of the /usr/games/variety). Subgroups 
include *net.games.rogue^ *net.games.frp' (for fantasy role playing games,) and 
‘net.games.trivia*. 

Topics of interest to amateur radio operators. 

The latest good joke youVe heard. 

Local area network interest group. 

Large Scale Integrated Circuit discussions. 

Miscellaneous discussions that start in net.general but are not permanent 
enough for their own newsgroup. 

Movie reviews by members of USENET. 

Computer generated music. 

Discussion of netnewa itself. Subgroups discuss or post various aspects of net- 
news, including ‘net.news.b’ for the B version of netnewSf *net.news.directory’ 
to post all or part of the USENET directory, ‘net.news.group’ for discussions 
about proposed new newsgroups, 'net.news.map’ to post maps of USENET or 
additions/corrections to previously posted maps, ‘net.news.newsite’ to 
announce a new site, ‘net.news’ itself is used for discussions relating to 
USENET policies and the like, rather than any specific software. 

Office Automation/Word Processing interest group. 

Queries and discussions about particular peripherals. (“Does anyone have a 
driver for a frammis-11?”) 

Recreational games. This differs from ‘net.sport’ in that *net.rec’ discusses 
games where one generally participates, but ‘net.sport’ is for spectator sports, 
‘net.games’ is for computer type games. Subgroups of ‘net.rcc’ include 
‘net.rec.bridge’ for contract bridge discussions, ‘net.rec.scuba’ for scuba divers, 
and ‘net.rec.ski’ for skiers. 

Discussions of phonograph records, albums, record stores, etc. 

For posting of rumors. 

For science fiction lovers. 

For posting source code for software distribution. 

Undigested, immediate distribution version of fa.space. 

Spectator sports. Subgroups include ‘net.sport.baseball’, ‘net.sport.footbair, 
and ‘net.sport.hockey’. 

Tax advice and queries. 

Test messages are posted here. Generally this is not interesting to ordinary 
readers. 

Requests, suggestions, and opinions about traveling. 

Circuit drawing system. 

ARPANET mailing list for UNIX AMzards. Anything and everything relating to 
UNIX is discussed here. This list is connected to the ARPANET mailing list but 
appears like a regular ‘net’ newsgroup to USENET. 
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_ net .wines 

o 


Information and recommendations about wines and alcoholic beverages. 



o 
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News Quick Reference 


Using News 

Command 

%rlogln newshoet 

%readnews 

%poftnews 

%lnews 

%cheeknews 


Meaning 

Connect to news host 

Display article headers 

Submit article or create newsgroup 

Submit article 

Check for news 


Resdnews Quick Help 

Command Meaning 

y Display article 

n Refuse article 

d Divide digest article 

q Quit 

U Unsubscribe from newsgroup 

c Cancel posted article 

r Reply to article anthcv 

f title Post follow-up article 

N newsgroup Go to next newsgroup 
s filename Save article in filename 

s I command Ron cmdwith article as input 

e Erase; forget article was read 

h Display verbose header; also H 

! Escape to Shell 

number Go to article number 

Return to previous article 
X Exit without updating 

V Display news version 

D Display crypted jokes 

+ Skip article for now 

X system Transmit article to named system. 

T Display command summary 

c, r, f, 8, e, and h can be followed by — to indicate 

the previous article 


Ckecknewg Command Line Options 

Option Action 
-y Notify of news arrival 

-V Display first newsgroup with unread 

news 

-n Display ‘No news/ if so 

-e Start readnews if there is news 

Make checknews quiet 


Inews Command Line Options 


Option 
-t title 

HI newsgroup 
expir. date 
-f sender 
-p filename 
-C newsgroup 


Action 
Submit article 

Specify newsgroups to receive article 
Set article expiration date 
Identify sender of article 
Receive articles from other machines 
Create newsgroup 


Readnews Command Line Options 


Option 

-n newsgroup 
-X 

-a date 
-t titles 
-1 

-P 

-r 

-M 

h: 

-c mailer 

-f 

-h 


Action 

Read specified newsgroup 
Ignore read articles record 
Read news since date 
Read articles with titles 
List article headers 
Display articles without input 
Display in reverse order 
Make interface to mail 
Make binmail^like interface 
Write articles to temporary file 
Prevent follow-up articles 
Display articles in succinct format 
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This glossary lists the most important terms in this introduction to the Sun system. 

• The name of your current directory displayed by the command pwi; also see dir$. 

Usually the first component of the search path contained in the variable pathy so 
commands in are found first. At the beginning of a component of a pathname, 
is treated specially and not matched by the filename expansion metacharacters 
and pairs. The character is also used in separating filename components. 

.. Each directory has a file in which is a reference to its parent directory. After 

changing into a directory with cdy you can return to the parent directory by typing 
cd •.. Then check the current directory with pwd, 

a.out The default file that contains the executable images that compilers create, 
absolute pathname 

A pathname which begins with a 7' b absolute since it specifies the path of direc* 
tories from the beginning of the entire directory system ~ called the root directory. 
Pathnames which are not absolute are called relative (see relative pathname). 

access mode 

The protection information for a file, ensuring a degree of privacy and safety for the 
user’s files in a shared system. Access mode details the operations allowed (reading, 
writing, or executing) by the three classes of users (owner, group, and public). Also 
called access privilege. 

alias An alias specifies a shorter or different name for a Sun system command, or a com¬ 
mand transformation to be performed in the Shell. The Shell has an alias command 
that establishes aliases and can show their current values. The command unalias 
removes aliases. 

argument 

Additional information that is passed to a command. The command name and its 
arguments are separated from one another by spaces and/or tabs. Arguments are 
usually used to direct the operation of a command. Thus the command echo a b c 
consists of the command name echo and three argument words ‘a’, *b’ and ‘c’. The 
set of arguments after the command name is the argument list of the command. 

background process 

A process that runs unattended in a manner that allows other programs to be ini- ‘ 
tinted and interacted with while the background process is running. 

base That part of a filename before any character. See also filename and extension. 
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bg The bg command causes a suspended job to continue execution in the background. 

bin A directory containing binaries of programs and Shell scripts to be executed. The 

standard system bin directories are jhin, containing the most heayily used commands 
and which contains most other user programs. Programs developed at UC 

Berkeley live in /tf«r/tic6, while locally written programs live in /tisr/Zocal Games 
are kept in the directory JuarjgamtB, You can place binaries in any directory. If 
you wish to execute them often, the name of the directories should be a component 
of the variable path. 

Bourne Shell 

The Shell program used in Version 7 UNIX. Named after its author S. R. Bourne. 

built-in A command that the Shell executes directly. Most commands in the Sun system are 
not built into the Shell, but rather exist as files in bin directories. 

buffer A place where data are stored temporarily. 

C Language 

A general-purpose programming language that is the primary language of the UNIX 
system. 

cat The cat command concatenates a list of specified files on the standard output. 

cd The cd command changes the working directory. With no arguments, cd changes 

your working directory to be your home directory. 

child process 

Each call to Tork’ creates a new process called the child of the original parent pro¬ 
cess. Each time you spin off a background job, the Shell executing it is a child of 
your current Shell. A command, or any process, can then spawn more children to 
complete specific portions of the task. A process id is specified in the p$ (process 
status) command by PID. See also parent process, 

chsh The chsh command changes the Shell which you use on the Sun system. By default, 
you use the C-Shell which resides in fbinfcsh, 

command 

An order directing the system to perform some function. A built-in command is han¬ 
dled internally by the Shell. However, most commands result in the execution of a 
program. 

command name 

When a command is issued, it consists of a command name, which is the first word 
of the command, followed by arguments. The convention is that the first word of a 
command names the function to be performed. 

command file 

An ordinary file that contains Shell commands; usually used when referring to a file 
that contains just one or a few commands. The term Shell program is usually used 
when there ar ea lot of commands or when the Shell’s facilities for looping and con¬ 
ditional execution are used. 

command interpreter 

A component of an operating system which decodes and executes the commands 
entered by the user. The Sun System command interpreter is called the Shell 
command name 

The first word of a command. The words following the command name are called 
the arguments. 
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compiler A computer program that translates a text file containing a program written in some 
high level programming language into a machine language output that can be exe> 
cuted. The machine language output from a compiler is called the object file. 

component 

The part of a pathname between 7* characters. A variable which has multiple 
strings as a value is said to have several componentoy each string is a component of 
the variable. 

concatenate 

To combine several files, one after the other; usually performed with the eat com¬ 
mand. 

context search 

Searching for a body of text in a given file by entering a text pattern you want the 
system to locate. You can perform a context search within the editor or you can 
perform context searches using the prep command. 

The built-in command that causes execution of the enclosing foreach or while loop to 
cycle prematurely. Similar to the continue command in the programming language 
C. 

Certain special characters called control characters control various functions, such as 
cursor movement or printing functions. They are produced by holding down the 
CTRL key on your terminal and simultaneously pressing another character, much 
like the SHIFT key is used to produce upper-case characters. To produce control-c 
(or "C), hold down the CTRL key while pressing the C key. Usually the Sun system 
shows a caret (*) followed by the corresponding letter when you type a control char¬ 
acter. 

core dump 

When a program terminates abnormally, the system places an image of its current 
state in a file named core. This core dump can be examined with the system 
debugger adb or dbi to determine what went wrong with the program. The Shell 
may produce a message of the form ‘Illegal instruction (core dumped)’ where illegal 
instruction’ is only one of several possible messages. 

cp The cp (copy) program copies the contents of one file into another file, 

csh The name of the Shell program for the C-Shell. 

•cshrc The file .cthre in your home directory that each Shell reads as it begins execution. 

It is usually used to change the setting of the variable path and to set alias parame¬ 
ters which are to take effect globally. 

current directory 

The directory whose files arc directly accessible. At any time, there is a current 
directory, whose name you can display by typing the pwd command. 

The cwd variable in the Shell holds the absolute pathname of the current working 
directory. The Shell changes it whenever your current working directory changes, 
and it should not be changed otherwise. 

Continually running processes, such as routedy the route daemon, Ipdy the line printer 
daemon, and rehdy the remote shell daemon, that supervise events and manage sys¬ 
tem resources accordingly. The delivermail daemon, for example, sends mail to the 
correct place when it notices that mail has arrived. 

The date command displays the current date and time. 


cwd 

daemon 

date 


continue 


Control- 
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debugging 

The process of correcting mistakes in programs and Shell scripts. The Shell has 
several options and variables which may be used to aid in Shell debugging. 

DELETE The DELETE or RUBOUT key on a terminal normally sends an INTERRUPT to the 
current job. The workstation default is "C. 

detached 

A process that continues running in the background after you logout, 
diagnostic 

An error message produced by a program. Most error messages are written to the 
diagnostic output, so diagnostics usually appear on the workstation screen. The 
diagnostic output may be directed away from the workstation. 

directory 

Directories contain files and are used to organise and structure the file system. At 
any time you are in one particular directory whose name can be shown by the com¬ 
mand pwd. The cd command changes you to another direetoryj and makes the files 
in that directory visible. The directory which you are in when you first log in is 
your home directory. 

directory stack 

The C-Shell saves the names of previous working directories in the directory stack 
when you change your current working directory with the ptiakd command. To 
display the directory stack use the dirs command, which includes your current work¬ 
ing directory as the first directory name on the left. 

The dirs command displays the C-ShelFs directory stack. 

Short for ‘disk usage,* the du command shows the number of disk blocks in all direc¬ 
tories below and including your current working directory. 

The echo command displays its arguments. 

An end-of-fUe is generated by a "D, and whenever a command reads to the end of a 
file which it has been given as input. Commands receiving input from a pipe receive 
an end-of-file when the command sending them input completes. Most commands 
terminate when they receive an EOF. 

erase character 

Erases previously typed characters on the current input line one at a time. The 
default is the DEL key, which you can reassign with the stty command. 

escape A character ‘ \* that prevents the special meaning of a metacharacter; it escapes the 
metacharacters from their special meanings. 

/etc/p asswd 

The file containing the major login information (password, login name, userid 
number, the name of the user*s shell) for each user of the system. The jetejpasswd 
file consists of a line for each account with fields separated by characters. 

execute permission 

For ordinary files execute permission is an access mode that allows you to execute 
the file. For directory files execute permission is an access mode that allows you to 
search them in the course of resolving a pathname. 

expansion 

The replacement of strings in the Shell input which contain metacharacters by other 
strings. The replacement of the word **’ by a sorted list of files in the current direc¬ 
tory is a ‘filename expansion.* Similarly the replacement of the characters ‘11* by the 


dirs 

du 

echo 

EOF 
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text of the last command is a ^history expansion.^ 

extension 

Filenames often consist of a base name and an extension separated by the character 
By convention, groups of related files often share the same root name. Thus if 
prog.e were a C program, the object file for this program would be stored in prog.o. 
Similarly a paper written with the -ms nroff macro package might be stored in 
paper,msf while a formatted version of this paper might be kept in paper, oat and a 
list of spelling errors in paper,errs, 

fg The job control command that runs a background or suspended job in the fore¬ 

ground. 

filename Each file in the Sun system has a name consisting of characters, not including the 
character which is used in pathname building. Most filenames do not begin with 
the character and contain only letters and digits with perhaps a separating the 
base portion of the filename from an extension. 

filename expansion 

Filename expansion (also called filename generation) is the procedure that the Shell 
follows to expand command line words containing metacharacters and and 

into the corresponding list of filenames. You can name all the files in the current 
directory, or all files which have a common root name. Other filename expansion 
mechanisms use the metacharacter to easily name files in other users* directories. 

file system 

The hierarchical collection of files and file management structures (inodes). 

flag Many Sun system commands accept arguments which are not the names of files or 
other users, but modify the action of the commands. These are referred to as flag 
options or simply options^ and by convention consist of one or more letters usually 
preceded by the character —Thus the Is (list files) command has an option -s to 
list the sizes of files. 

foreground 

When commands are executing in the normal way such that the Shell is waiting for 
them to finish before prompting for another command, they are said to be fore¬ 
ground fobs or running in the foreground. Typing different control characters at the 
keyboard stops foreground jobs. See also background process. 

The grep command searches through a list of argument files for a specified string. 
Grep scans for regular expressions in the sense of the editors ed and ex. Grep stands 
for ^global regular expression print.’ 

Several users who are members of the same department, working on the same pro¬ 
ject, or related in some other way. Each system file is associated with a certain 
group, and members of that group have specified privileges for accessing the file. 

The head command shows the first few lines of one or more files. Head also describes 
the part of a pathname before and including the last 7’ character. 

header field 

At the beginning of a message, a line that contains information that is part of the 
structure of the message. Header fields include to, cc, and subject. 

hbtory The history mechanism of the Shell repeats previous commands, possibly after 
modification to correct typing mistakes or to change the meaning of the command. 
The Shell has a history list where these commands are kept, and a history variable 
which controls how large this list is. 


«i*ep 

group 

head 
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home directory 

Each user has a home directory^ which is defined in his entry in the password file, 
/etc/patswd. This is the directory which you are placed in when you first log in. 
The cd command with no arguments takes you back to this directory, whose name is 
recorded in the Shell variable home. You can also access the home directories of 
other users by forming filenames using a filename expansion notation and the char> 
acter 

ignoreeof 

Normally, your Shell will exit, displaying ‘logout’ if you type a "D at a hostname 
prompt. This is the way you usually log off the system. You can set the ignoreeof 
variable if you wish in your Aogtn file and then use the command logout to logout. 
This is useful if you sometimes accidentally type too many "D characters, logging 
yourself off. 

inode The key internal structure for managing files. Inodes contain all the information 
pertaining to the mode, type, owner, and location of a fie. 

input The information that many Sun system commands take from the workstation or files 
and act on. Commands normally read for input from their standard input which is, 
by default, the workstation or terminal. This standard input can be redirected from 
a file using the Shell metanotation character ‘<’. Many commands also read from a 
file specified as argument. Commands placed in pipelines read from the output of 
the previous command in the pipeline. The leftmost command in a pipeline reads 
from the workstation or terminal if you neither redirect its input nor give it a 
filename to use as standard input. Special mechanisms exist for supplying input to 
commands in Shell scripts. 

interrupt 

A signal to a program that is generated by typing "C (or the RUBOUT or DELETE 
key on some terminals), which causes most programs to stop execution. Certain pro¬ 
grams, such as the Shell and the editors, handle an interrupt in special ways, usually 
by stopping what they are doing and prompting for another command. While exe¬ 
cuting another command and waiting for it to finish, the Shell does not listen to 
interrupts. Typing an interrupt often wakes up the Shell because many commands 
die when interrupted. 

job One or more commands typed on the same input line separated by ‘|’ or charac¬ 

ters and run together. Simple commands run by themselves without any ‘|’ or 
characters are the simplest jobs. Jobs are classified as foreground, background, or 
suspended. 

job control 

The built-in functions that control the execution of jobs. These functions are bg, fg^ 
stopy and kill. 

job number 

When each job is started it is assigned a small job number, which is displayed next 
to the job in the output of the jobs command. Use this number, preceded by a 
character, as an argument to job control commands to indicate a specific job. 

jobs The jobs command displays a table showing jobs that are either running in the back¬ 
ground or are suspended. 

kernel The memory resident part of the UNIX operating system, containing all of the sys¬ 
tem functions that are needed immediately and frequently. The kernel supervises 
the I/O transactions, manages and controls the hardware, and schedules the user 
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processes for execution. 

kill A command which sends a signal to a job causing it to terminate, 

kill character 

The "U character, used to erase the entire current line. This may be reassigned with 
the command. 

•login The file Jogin in your home directory is read by the Shell each time you log in to the 
Sun system, and the commands contained there are executed. A number of com¬ 
mands are usually placed in Joginy especially set commands to the Shell itself. 

login directory 

Same as home directory. 

login Shell 

The Shell that is started on your workstation when you log in. It is different from 
other Shells which you may run (such as on Shell scripts) in that it reads the .login 
file before reading commands from the workstation or terminal, and it reads the 
.logout file after you logout. 

logout The logout command causes a login Shell to exit. Normally, a login shell exits when 
you type "D generating an end-of-file, but if you have set ignoreeoj in your .login 
file, this will not work and you must use logout to log off the Sun system. 

•logout When you log off the Sun system, the Shell executes commands from the file .logout 
in your home directory after it displays ‘logout.’ 

Ipr The line printer daemon command. The standard input of Ipr is spooled and printed 

on the line printer. You can also give Ipr a list of filenames as arguments to be 
printed. 

b With no argument filenames, the Is command shows the names of the files in the 

current directory. It has a number of useful flag arguments, and can also be given 
the names of directories as arguments, in which case it lists the names of the files in 
these directories. 

macro package 

A set of high level nr off/ troff text formatting requests for more convenient text pro¬ 
cessing functions. 

mail The mail transmits memos, messages, and letters to other users of the same system 
and to users on other systems. 

mailbox The place where your mail is stored, typically in the directory Iusrf spoolf mail. 
message A single letter from someone, initially stored in your mailbox. 

message list 

A string used in mail command mode to describe a sequence of messages. 

metach ar acter 

The characters that are neither letters nor digits that have special meaning either to 
the Shell or to the Sun system. Enclose them in quotes if it is necessary to place 
these characters in arguments to commands without them having their special mean¬ 
ing. An example of a metacharacter is the character ‘>’ which indicates placement 
of output into a file. For the purposes of the history mechanism, most unquoted 
metacharacters form separate words. 

mkdir The mkdir command creates a new directory, 
modifier 

Substitutions with the history mechanism, keyed by the character ‘!’ or by variables 
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using the metacharacter are often subjected to modifications, indicated by plac* 
ing the character after the substitution and following this with the modifier itself. 

more The more program shows a file on your workstation and allows you to control how 
much text is displayed at a time. More can move through the file screenful by 
screenful, line by line, search forward for a string, or start again at the beginning of 
the file. 

noclobber 

The Shell variable that prevents accidental destruction of files by the ‘>’ output 
redirection metasyntax of the Shell if set in the file .login 

noglob The Shell variable that suppresses the filename expansion of arguments containing 
the metacharacters ‘[’ and ‘]\ 

notify The notify variable tells the Shell to report on the termination of a specific back¬ 
ground job at the exact time it occurs as opposed to waiting until just before the 
next prompt to report the termination. If set, the notify variable causes the Shell to 
always report the termination of background jobs exactly when they occur. 

object file 

A file containing machine language that can be executed by the workstation. An 
object file is the result of a compilation. 

ordinary file 

Used for storing data in the form of programs, documents, letters data bases, and 
other types of information. 

output The lines of text resulting from many Sun system commands. This output is usually 
placed on what is known as the standard output, which is normally connected to the 
user’s workstation. The Shell has a syntax using the metacharacter *>’ for redirect¬ 
ing the standard output of a command to a file. Using the pipe mechanism and the 
metacharacter it is also possible for the standard output of one command to 
become the standard input of another command. Certain commands such as the line 
printer daemon Ipr do not place their results on the standard output but rather on 
the line printer. Similarly the write command places its output on another user’s 
workstation rather than its own standard output. Commands also have a diagnostic 
output where they write their error messages. Normally these go to the workstation 
even if the standard output has been sent to a file or another command, but it is 
possible to direct error diagnostics along with standard output using a special nota> 
tion. 

parent process 

A process from which other processes called children are run. Parents can run simul¬ 
taneously with their children, or can wait for the children to ‘die’ before proceeding, 
depending on the task. Specified as PPID, the parent process id number, by the ps 
(process status) command. See also child process. 

The Shell variable that gives the names of the directories in which it searches for the 
commands which it is given. Path always checks first to see if the command it is 
given is built into the Shell. If it is, then it need not search for the command as it 
can do it internally. If the command is not built in, the Shell searches for a file with 
the name given in each of the directories in the path variable, left to right. Since the 
normal definition of the path variable is .| /usr/ucb\ /bin\ fusrfbin, the Shell nor¬ 
mally looks in the current directory, and then in the standard system directories 
/usrfucb, /bin and /usr/bin for the named command. If the command cannot be 
found the Shell displays an error diagnostic. Scripts of Shell commands are executed 
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using another Shell to interpret them if they have ^execute' permission set. If you 
add new commands to a directory in the path, use the command rehash, 

pathname 

A path through the file system that leads to a file. It is formed by listing directory 
names separated by slashes (/*s) to define the path. Each component of a pathname, 
between successive 7’ characters, names a directory in which the next component 
file resides. Pathnames which begin with the character 7* arc interpreted relative to 
the root directory in the filesystem. Other pathnames are interpreted relative to the 
current directory as reported by pwd. The last component of a pathname may name 
a directory, but usually names a file. 

permissions 

The access modes associated with a file. See access mode. 


pipe 

pipeline 


popd 


port 


pr 


A connection between the standard output of one program and the standard input 
of another program. The Shell metacharacter ‘p indicates the pipe mechanism. 

A group of commands connected together, the standard output of each being con¬ 
nected to the standard input of the next. 

The popd command changes the ShelFs working directory to the directory you most 
recently left using the pushd command. It returns to the directory without having to 
type its name, forgetting the name of the current working directory before doing so. 

The part of a computer system to which each terminal is connected is called a port. 
Usually the system has a fixed number of ports, some of which are connected to tele¬ 
phone lines for dial-up access, and some of which are permanently wired directly to 
specific terminals. 

The pr command prepares listings of the contents of files with headers giving the 
name of the file and the date and time at which the file was last modified. 


printenv 

The printenv command displays the current setting of variables in the environment. 

process A program that is being executed; an entry in the system^s process table. The sys¬ 
tem assigns each process a unique process id number (PID) when it is started. Use 
process id numbers to stop individual processes with the kill or stop commands when 
the processes are part of a detached background job. See also child and parent pro¬ 
cess. 


program 


Usually synonymous with command; a binary file or Shell command script that per¬ 
forms a useful function. 


prompt The indication by a program on the screen that it is ready to accept input. The 
Shell prompts for input with *hostname% * and occasionally with when reading 
commands from the workstation. The Shell has a variable prompt which may be set 
to a different value to change the ShelPs main prompt. This is mostly used when 
debugging the Shell. 

ps The ps command shows processes you are currently running, each process being 

listed with its unique process number, an indication of the terminal name it is 
attached to, an indication of the state of the process (whether it is running, stopped, 
awaiting some event (sleeping), or whether it is swapped out), and the amount of 
CPU time it has used so far. A command is identified by listing some of the words 
used when it was invoked. Shells, such as the csh you use to run the ps command, 
are not normally shown in the output. 
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pushd The pushd command, which means *push directory’, changes the Shell’s working 
directory and also remembers the current working directory before the change is 
made, so you can return to the same directory with the popd command later without 
retyping its name. 

pwd The pwd command displays the full pathname of the current working directory, simi¬ 
lar to the dirs built-in command. 

quit The signal generated by a control-\ (^\), that terminates programs which are behav¬ 
ing unreasonably. Quit normally produces a core image file. 

quoting The process by which metacharacters are prevented from having their special mean¬ 
ing, usually by using the character ’ in pairs, or by using the character ‘\’, 

read permission 

Allows a person to execute a program that reads data from a file, 
redirection 

The Shell’s reassigning of standard input to a file other than the workstation and of 
reassigning the standard output to a specified file. 

regular expression 

A regular expression specifies a set of strings of characters. 

rehash The rehash command tells the Shell to rebuild its internal table of which commands 
are found in which directories in your path. This is necessary when a new progpram 
is installed in one of these directories. 

relative pathname 

A pathname that does not begin with a 7' since it is interpreted relative to the 
current working directory. The first component of such a pathname refers to some 
file or directory in the working directory, and subsequent components between 7^ 
characters refer to directories below the working directory. See also absolute path¬ 
names. 

repeat The repeat command iterates another command a specified number of times. 

root The directory that is at the top of the entire directory structure; it is the ‘root’ of 

the entire tree structure of directories. The 7’ indicates the root name in path¬ 
names. Pathnames starting with 7’ su’e absolute since they start at the root direc¬ 
tory. Root is also used as the part of a pathname that is left after removing the 
extension. See filename for a further explanation. 

scratch file 

Files whose names begin with a ‘#’ and are automatically removed by the system 
after a couple of days of non-use, or more frequently if disk space becomes tight. 

set The built-in command that assigns new values to Shell variables and when used by 

itself shows the values of the current variables. Many Shell variables have special 
meaning to the Shell itself, so using the set command can affect the behavior of the 
Shell. 

setenv The built-in command that changes variables in the environment ‘environ’. The 
printenv command displays the value of the variables in the environment. 

shell A command language interpreter. It is possible to write and run your own Shell, as 
Shells are no different than any other programs as far as the system is concerned, 
shell program 

A program written using the Shell programming language. Shell programs can be 
written and executed interactively, although most Shell programs are stored in 


A-10 


Revision D of 7 January 1984 





Beginner s Guide 


Glossary 


ordinary files. 

signal A short message that is sent to a running program which affects that process. Sig¬ 
nals are sent either by typing special control characters on the keyboard or by using 
the kill or stop commands. 

sort The sort program sorts a sequence of lines in ways that you can control with argu¬ 
ment flags. 

source The source command reads commands from a specified file. It is most useful for 
reading files such as ,cshre after changing them. 

special character 

See metacharacters, 

special file 

Files that provide an interface to I/O devices, 
standard I/O 

Many programs need to read commands and data from the user, write messages to 
the user, and write error messages. Therefore, the Shell prepares three standard I/O 
connections for each program, the standard input, the standard output, and the 
standard error. The standard channels are usually connected to the user’s worksta¬ 
tion although they can be reassigned using redirection. 

A command normally returns a status when it finishes. By convention a status of 
zero indicates that the command succeeded. Commands may return non-zero status 
to indicate that some abnormal event has occurred. The Shell variable status is set 
to the status returned by the last command. It is most useful in Shell command 
scripts. 

The stop command suspends a background job. 

A sequential group of characters taken together. Strings can contain any printable 
characters. 

The stty program changes certain parameters inside the Sun system to determine 
how your workstation or terminal is handled. See stty in the user’s manual for a 
complete description. 

subdirectory 

A directory below another directory in the file system hierarchy, 
substitution 

The Shell implements a number of substitutions where sequences indicated by meta¬ 
characters are replaced by other sequences. Notable examples of this are history 
substitution keyed by the metacharacter M’ and variable substitution indicated by 
‘$’. We also refer to substitutions as expansions, 

superuser 

A special privilege level that exists to allow system managers to perform certain 
functions that are denied to ordinary users. The superuser is not constrained by the 
normal file access mode system. 

suspended 

A job becomes suspended after a STOP signal is sent to it, either by typing a *Z (for 
foreground jobs) or by using the stop command (for background jobs). When 
suspended, a job temporarily stops running until it is restarted by either the fg or bg 
command. 


status 

stop 

string 

stty 
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system call 

A request by an active process for a service by the kernel. System calls perform I/O, 
control, coordinate, and create processes, and read and set various status elements of 
the system. 

termination 

Occurs when a command which is being executed finishes. Commands normally ter¬ 
minate when they read an end*of-file from their standard input. It is also possible to 
terminate commands by sending them an interrupt or quit signal. The kill program 
terminates specified jobs. 

time The time command measures the amount of CPU and real time used by a specified 
command as well as the amount of disk I/O, memory utilized, and number of page 
faults and swaps taken by the command. 

tset The tset program sets standard erase and kill characters and tells the system what 

kind of terminal you are using. It is often invoked in a .login file. 

tty The historical abbreviation for ‘teletype’ which is frequently used in the Sun system 

to indicate the port to which a given workstation is connected. The tty command 
displays the name of the tty or port to which your workstation or terminal is 
presently connected. 

unalias The unalias command removes aliases. 

UNIX The operating system on which the Sun system is based, 
unset The unset command removes the definitions of Shell variables. 

variable expansion 

See variables and expansion. 

variables 

Contain one or more strings as value and control the behavior of the Shell. 

verbose A Shell variable that echoes commands after they are expanded by the history 
mechanism. This is often useful in debugging Shell scripts. The verbose variable is 
set by the Shell’s —v command line option. 

wc The wc (word count) command counts the number of characters, words, and lines in 

the files whose names are given as arguments. 

word A sequence of characters which forms an argument to a command. Many characters 
which are neither letters, digits, ‘.* nor ‘/’ form words all by themselves even if 
they are not surrounded by blanks. Any sequence of characters may be made into a 
word by surrounding it with ’ characters except for the characters *' ’ and ‘!’ 
which require special treatment. This process of placing special characters in words 
without their special meaning is called quoting. 

working directory 

The particular directory you are in at any given time. Pwd displays this directory’s 
name and Is lists its files. You can change working directories using ed. 

write The write command communicates with other users who are logged in to the system, 
write permission 

Allows a user’s programs to write data to a file. 
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READER COMMENT SHEET 


Dear Customer, 

We who work here at Sun Microsystems wish to provide the best possible documentation for 
our products. To this end, we solicit your comments on this manual. We would appreciate 
your telling us about errors in the content of the manual, and about any material which you 
feel should be there but isn^t. 


Typographical Errors: 

Please list typographical errors by page number and actual text of the error. 


Technical Errors: 

Please list errors of fact by page number and actual text of the error. 


Content: 

Did this guide meet your needs? If not, please indicate what you think should be 
added or deleted in order to do so. Please comment on any material which you feel 
should be present but is not. Is there material which is in other manuals, but would be 
more convenient if it were in this manual? 


Layout and Style: 

Did you find the organization of this guide useful? If not, how would you rearrange 
things? Do you find the style of this manual pleasing or irritating? What would you 
like to see different? 
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